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The Hewlett-Packard Distributed Systems Network (HP-DSN) is a set 
of hardware and software data conuntmi cat ions products. One of 
these data communications products is DSN/Distributed Systems 
(DSN/DS) which is an integrated software package that provides 
the capability of communication between HP computer systems. 

This manual documents DSN/DS as it applies to an HP 3000 network. 
(This HP 3000-to-HP 3000 application of the DSN/DS software sub- 
system was identified in the previous edition of this manual as 
DS/3000.) The manual explains how an HP 3000 user can communi- 
cate with another (or several other) HP 3000 computer systems by 
establishing a DSN/DS communications link. (Other manuals in the 
DSN/DS series document the other network combinations of computer 
tjrpes . ) 

This dual-purpose manual serves as both a reference manual for 
experienced users of HP DSN/DS and a tutorial text for new HP 
DSN/DS users. A new user should be familiar with the basic oper- 
ating principles of the HP 3000 Computer System using the MPE 
Operating System and should also be knowledgeable in the subjects 
of the following manuals: 

• HP 3000 Computer Systems, HPE Commands Reference Manual 
(30000-90009). 

• HP 3000 Computer Systems, HPE Intrinsics Reference Manual 
(30000-90010). 

• HP 3000 Computer Systems, System Manager /System Supervisor 
Reference Manual (3OOOO-9OOIU) . 

• HP 3000 Computer Systems, Console Operator's Guide 
(32002-90001*). 

• HP 3000 Computer Systems, Communications Handbook 
(30000-90105)- 



For those users who also become involved in the selection and/or 
connection of the various network components, reference should be 
made to the appropriate component manuals, including the 
following: 

• HP 3OOIOA Intelligent Network Processor (INP) 
Installation and Service Manual (3OOIO-9OOOI) . 

• HP 30O2OA Intelligent Network Processor (INP) 
Installation and Service Manual (3002O-9OOOI) . 

• HP 3OO2OB Intelligent Network Processor (INP) 
Installation and Service Manual (3OO2O-9OOO5) . 
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HP 3OOIOA/3OO2OA/B Intelligent Network Processor (INP) ' J 

Diagnostic Procedures Manual (30010-90002). 

HP 3OO55A Synchronous Single-Line Controller (SSLC) 
Installation and Service Manual (3OO55-9OOOI) • 

Hardwired Serial Interface (HSI) 

Installation and Service Manual (30360-9OOOI). 



NOTE 



Within the text of this manual, cross- 
references are made to other manuals "by 
title. To obtain the part n\imber of the 
referenced manual, refer to these lists 
of manuals in the Preface. 



This second edition of the DSN/DS Reference Manual not only "^ 

incorporates all of the various updates that were issued since V 

the first edition was published, but it also includes some new 
material. The Network File Transfer (NFT) documentation (that 
was appended to Section III in Update No. 5) has now been 
reformatted as Section VI. Another new section -- Section VII, 
DS Applications -- has been added to expand upon the coverage of 
the advanced uses and networking possibilities available with the 
enhanced DSN/DS. The new Appendix H documents the X.25 Network 

Configurator; and the new Appendix J is a commentary on using "^ 

Public Data Networks (PDNs) with the new DS/X.25 capability, as 
well as the X.29 Packet Assembler /Disassembler (PAD) that expands 
the system-to-system X.25 capability to include a terminal-to- 
system capability. Appendix A, Configuration Dialogue, has also 
been updated to include the new driver names required for the 
utilization of DS/X.25. Additionally, all of the previously 
existing sections and appendices have been edited and brought up 
to date. 
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[] 



{} 



italics 
underlining 

superscript C 

return 
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DESCRIPTION 

An element inside brackets is optional. Several elements stacked inside a pair of brackets means 
the user may select any one or none of these elements. 



Example: 



K 



user may select A or B or neither 



When several elements are stacked within braces the user must select one of these elements. 



Example: { B 
C 



user must select A or B or C. 



Lowercase italics denote a parameter which must be replaced by a user-supplied variable. 

Example: CALL name 

name one to 15 alphanumeric characters. 

Dialogue: Where it is necessary to distinguish user input from computer output, the input is 
underlined. 

Example: NEW NAME? ALPHAl 

Control characters are indicated by a superscript C 

Example: Y^ 

return in italics indicates a carriage return 

linefeed in italics indicates a linefeed 

A horizontal ellipsis indicates that a previous bracketed element may be repeated, or that elements 
have been omitted. 



/<^k 



-^ 



'*''^\ 



xiv 



#^. 



i^^S 



#^ 






ii^P^^^i 



INTRODUCING DSN/DS 



SECTION 



The Hewlett-Packard Distributed Systems Network (HP-DSN) is a 
combination of hardware and software products that make it pos- 
sible for Hewlett-Packard computer systems to communicate with 
one another, and with IBM mainframes as well. The connections 
can be made over hardwired lines, and/or over the public tele- 
phone facility, and/or across Public Data Networks (PDNs), in any 
mixture • This capability, coupled with our proven remote entry 
capability to IBM computer systems, provides a total solution to 
large-company electronic data processing (EDP) needs. 



Within the realm of HP-DSN is the software subsystem that 
accomplishes computer-to- computer communication over these 
connecting lines* This software subsystem is called 
DSN/Distributed Systems (DSN/DS). Among other features, DSN/DS 
includes such capabilities as: 



Remote File Access. A user is allowed access to files in 
remote HP computer systems. -An important aspect of this 
feature is the capability of using Interprocess 
Communications (IPC) between systems. 

Remote Data Base Access. A user can directly access data 
bases on any remote HP computer under the same security 
protection used by local data bases. 

Program-to-Program Communication. Permits programs 
residing in different HP computer systems to interactively 
exchange information with one another in a coordinated 
manner. 

Virtual Terminai. Gives the user remote interactive 
capabilities, even though the user's terminal is physically 
connected to the local HP system. 

Remote Command Execution. Allows the user to issue 

commands to a remote HP system as if the local terminal were 

connected directly to the remote system. 

Networic File Transfer. A facility that efficiently 
transfers disc files between HP computer systems. 

X.2S/X.21. Gives communication capability across X.25 

packet switching and X.21 circuit switching networks to the 

DSN/DS user. 
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But exactly what does this overall capability mean? It means 

that a large multidivisional corporation can have a truly coord- ""^ 

inated world-wide network of computer systems. They are coordin- 

ated in the sense of tying together the various commercial and 

industrial functions within each division and factory, and they 

are also coordinated in the larger sense of tying together the 

various divisions and factories at the corporate level. 

For example, imagine a large corporation which has factories in 
the United States, Canada, France, and West Germany. Within each 
factory there are HP 3000 computer systems performing such func- 
tions as inventory control, factory data collection, and opera- 
tions management. With a Hewlett-Packard Distributed Systems 
Network these manufacturing information systems can be tied into 
an HP 3000 system which handles the factory's administrative 
functions (such as finance and accounting). The administrative 
systems of each factory can, in turn, be connected not only to 
one another but also (via remote job entry) to a large computer 
facility at corporate headquarters. This overall networking cap- 
ability makes it possible to perform financial analysis and 
control at a group and corporate level as well as at the indiv- 
idual factories. 



This manual describes how an HP 3000 user can communicate with .^^^ 

several HP 3000 computers by establishing a DSN/DS communications ; 

link. DSN/DS is that part of the HP Distributed Systems Network 

in which several HP 3000 computer systems are connected to one 

another. DSN/DS can also be used for intercomputer 

commxmi cat ions with other families of computers (such as 

HP 3000/HP 1000, HP 3000/HP 250, and HP 3000/HP 98xx desktop 

computers), but these other combinations are described in 

separate reference manuals. 

As a simplified example of a computer network, imagine that you / 

are in the same room with an HP 3000 (labeled "System A" in 
figure 1-1) and that another HP 3000 (labeled "System B") resides 
in another part of the building. These two computers are con- 
nected to one another by an interconnecting cable and a pair of 
communications interfaces. By virtue of DSN/DS you can use the 
processing capability of both of these HP 3000 machines and pass 
data back and forth between them by entering commands through a 
single terminal. 

To see how DSN/DS works in this simple example, follow through 
the step-by-step procedure. 
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Figure 1-1 • HP 3000 to HP 3000 Example 
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Step 1, Sit down at a terminal connected to System A and 
initiate a session* 



carriage return 

: HELLO USER •ACCOUNT 



^0\^ 



HP3000 / MPE IV COO. Oil. WED, MAR 3, 1982, 9:05 AM 



WELCOME TO SYSTEM A. 



Within the context of DSN/DS, such a 
"local" session because it is active 
your terminal is directly connected* 
more meaningful later, since all you 
is initiate a standard MPE session, 
reached the situation illustrated in 



session is referred to as a 
within the HP 3000 to which 

This terminology becomes 
have actually done, so far. 
At this point, you have 
figure 1-2. 
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Figure 1-2. Initiating the Local Session 
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Step 2. Now, open a communications line between System A and 
System B. Do this by entering a DSLINE command. 



:DSLINE HDS2 



/-^ 



DS LINE NUMBER = #L3 



In this example, HDS2 is the device class nsune established during 
system configuration (in System A) for the particular line you 
wish to use. DSN/DS opens the line and then assigns you a line 
niunber (3 in this example). This line number is analagous to the 
file number returned to you by the MPE File System when you open 
a file programmatically using the FOPEN intrinsic. Within your 
local session, it uniquely identifies the particular line that 
you have opened. This becomes significant only if you must open 
more than one communications line during a session. 
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Step 3. Now that you have acquired access to a communications 
line between System A and System B, initiate a session in System 
B (from your local log-on terminal)* Do this by entering a 
REMOTE command which includes an MPE HELLO command for the remote 
system. 



; REMOTE HELLO RUSER . RACCOUNT 

HP3000 / MPE IV C.OO.Ol*. WED, MAR 3, 1982, 9:08 AM 
WELCOME TO SYSTEM B. 
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Within the context of DSN/DS, this type of session is referred to 
as a "remote" session because it is active within the remotely 
located HP 3000 that is connected indirectly to your log-on term- 
inal by way of a communications line and your local HP 3000 • You 
now have two distinct sessions in progress concurrently: one in 
System A (under the user and account names USER •ACCOUNT) and the 
other in System B (under the user and account names 
RUSER.RACCOUNT) • It is important to keep in mind that within 
System A your local session is operating under the capabilities 
and security restrictions defined (by the accounting structure of 
System A) for USER .ACCOUNT, while within System B your remote 
session is operating under the capabilities and security 
restrictions defined (by the accounting structure of System B) 
for RUSER.RACCOUNT. At this point, the situation is as 
illustrated in figure 1-3. As will be seen in the next few 
steps, you can alternate freely between the two sessions. 
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Figure 1-3. Initiating the Remote Session 
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Step 4. Now, see what files reside in the home group of the 
ACCOUNT account in System A. 



; LISTF 

FILENAME 

DATAl DATA3 FILEl S0URCE2 S0URCE5 



You can do the same for the home group of the RACCOUNT account 
in System B by entering the following command through the same 
terminal: 



: REMOTE LISTF 

FILENAME 

DATAl DATA5 DATA6 FILE3 SOURCEl 



Notice that in both cases the same command was entered, but in ''"^ 

the latter case the prefix REMOTE was used. The presence or ^ 

absence of that prefix is what determines whether a command is to 
be executed in the local session or in the remote session. 



Step 5. As a result of the LISTF and REMOTE LISTF displays , '^ 

you can see that a source file, named SOURCEl, exists in System B ^ 

but not in System A. Suppose you wish to modify one of the 
statements in that program. To do that, use the text editor in 
System B. This time, instead of prefixing your remote commands 
with REMOTE,, try a different technique. Enter the following: 

; REMOTE 



This construct gets into the remote session in such a way that 
all commands can be entered in their normal form (without the 
prefix REMOTE). The # is the prompt character issued by DSN/DS 
(in place of the usual MPE colon prompt). In all other respects 
it will seem as though you are executing a normal MPE interactive 
session. 
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Step 6. Now invoke the text editor, copy the content of 
SOURCEl (fdiich is a file in System B) into the editor ' s work 
file, display the content of the work file, modify the desired 
statement, and store the altered soiirce code back in SOURCEl. 



f EDITOR 

HP322OIA.7.O5 EDIT/3000 WED, MAR 5. 1980, 3:i*7 PM 

(C) HEWLETT-PACKARD CO. 1979 

/ SET FORMAT=COBOL 

/ T SOURCEl 

/ LIST ALL 

1 $CONTROL USLINIT, SOURCE 

1.1 IDENTIFICATION DIVISION. 

1.2 PROGRAM-ID. COBOL-TESTl. 

1.3 ENVIRONMENT DIVISION. 
1.1* DATA DIVISION. 

1.5 WORKING-STORAGE SECTION. 

1.6 77 EDIT-FIELD PIC $$$$$9.99. 

1.7 77 TOTAL -COST PIC 999V99. 

1.8 77 COST-OF-SALE PIC 99V99. 

1.9 77 TAX PIC 99V99. 

2 77 Y-N PIC X. 

2.1 PROCEDURE DIVISION. 

2.2 ENTER-ROUTINE. 

2.3 MOVE ZEROS TO TOTAL -COST. 
2.1* DISPLAY SPACE. 

2.5 DISPLAY "ENTER COST OF SALE". 

2.6 ACCEPT COST-OF-SALE. 

2.7 COMPUTE TAX = COST-OF-SALE * .06. 

2.8 ADD COST-OF-SALE, TAX TO TOTAL-COST. 

2.9 MOVE TOTAL -COST TO EDIT-FIELD. 

3 DISPLAY "TOTAL COST= " EDIT-FIELD. 

3.1 DISPLAY "ARE YOU FINISHED? (Y OR N)". 

3.2 ACCEPT Y-N. 

3.3 IF Y-N = "N" OR "n" GO TO ENTER-ROUTINE. 
3.U STOP RUN. 

/ MODIFY 2.3 
MODIFY 2.5 

DISPLAY "ENTER COST OF SALE". 

I (NO DECIMAL POINT) 

DISPLAY "ENTER COST OF SALE (NO DECIMAL POINT)". 

/ KEEP SOURCEl 

SOURCEl ALREADY EXISTS - RESPOND YES TO PURGE OLD AND KEEP NEW 

PURGE OLD? YES 

/ EXIT 

END OF SUBSYSTEM 
I 
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Step 7. The work in System B is now conrpleted; so terminate 
the remote session and return control to your local session. 



#BYE 



CPU=U. C0roiECT=7- WE©, MAR 3, 1982, 9:15 AM 
#: 



Note that you are now back in the local session in System A 
(signified by the colon prompt). The remote session no longer 
exists, but the commxuii cat ions line is still open. You could, if 
you wanted, initiate another remote session over the line by 
issuing another REMOTE HELLO command. To close the 
commxinications line, enter the following variation of the 
DSLINE command: 



: DSLINE HDS2 ; CLOSE 
1 DS LINE WAS CLOSED. 



Finally, terminate the local session. 



:BYE 



CPU=1. CONNECT^ll. WED, MAR 3, 1982, 9:l6 AM 



/<^5%^ 



^'^^V 
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SECTION 



II 



WHAT IS A COMMUNICATIONS LINK? 

Within the context of DSN/DS, a "communications link" consists 
of the following elements: 



^PN 



• A normal interactive session in progress in an HP 3000 
computer. 

• A physical communications line between that HP 3000 computer 
and another HP 3000 computer at a remote location* 

• An interactive session in progress in the remote HP 3000 
computer (initiated over the physical communications line from 
your local session). 



Note that your local terminal is the log-on terminal for both the 
local session and the remote session. (Refer to figure 2-1.) 



/^^N 



HP 3000 



HP 3000 




Communications Line 




User's Log-On Terminal 



Figure 2-1. DSN/DS Communications Link (HP 3000 to HP 3000) 
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OPENING A LINE 



A communications link can be established over a hardwired commu- 
nications line, over the public telephone network, or over an 
X,21 or X.25 Public Data Network (PDN) . The procedures for open- 
ing hardwired lines and for opening telephone lines differ only 
slightly. Therefore, the basic differences will be presented 
first, followed by the procedures that are essentially the same. 
Generally, once the connection to the remote computer is estab- 
lished, you will perceive no difference in the way DSN/DS per- 
forms . 



Opening a Hardwired Line 



What is a hardwired line? In the general field of data communi- 
cations there are two types of lines commonly referred to as 
"hardwired". The first type is a dedicated path on the public 
telephone network that is leased from the telephone company for 
the private use of a computer-to- computer configuration. Such a 
line serves as a permanent connection between the two computers. 
The other type of hardwired line is a cable that is connected 
directly to the communications I/O interfaces of the two 
computers. Within the context of DSN/DS, "hardwired" always 
refers to the latter. However, the technique used for opening a 
line is the same for either a direct-connect line or a leased 
(nonswitched) telephone line. 

The hardwired interconnecting cable connects to each HP 3000 by 
way of a communications interface* The communications interfaces 
that can be used for a hardwired connection include the HP 
3OOIOA, HP 3OO2OA, and HP 30020B Intelligent Network Processor 
(INP), the HP 3OO55A Sjmchronous Single-Line Controller (SSLC), 
and the HP 3036OA Hardwired Serial Interface (HSI). (Although 
the INPs and the SSLC are the interfaces most commonly used for 
telephone line connections with modems, they can also be used in 
hardwired applications without modems.) The HP 30010A INP is 
used with the HP 3000 Series II/III; the HP 30020A INP is used 
with the HP 3000 Series 30/33/U0/l*l4; the HP 30020B INP is used 
with the HP 3000 Series 30/33/U0/UU/6U; the HP 30055A SSLC is 
used with the HP 3000 Series II/III; and the HP 3036OA HSI is 
used with the HP 3000 Series II/III. 

It is relatively straightforward to obtain access to a hardwired 
communications line. All you are required to do is identify the 
particular communications interface you wish to use. You do this 
by specifying the device class name or logical device number 
associated during system configuration with the desired inter- 
face. In the example in Section I, the DSLINE command was used 
for this purpose, as follows: 



: DSLINE HDS2 
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In the DSLINE command you may also wish to specify the size of 
the DSN/DS line buffer to be used in conjimction with the line. 
The size of this buffer determines the maximum amount of data 
that can be sent or received in a single physical transmission 
over the line. Note that a transmission as you normally think of 
it (sending or receiving all or part of a file) may actually con- 
sist of many physical transmissions. In essence, this buffer 
size defines a blocking factor for the line. (Refer to figure 
2-2.) A default buffer size is established during system config- 
uration, and in most cases (as in the example in Section I), you 
will find it satisfactory to let this default value prevail. 



jS^SS!Si?\ 







Assume that the DSN/DS line buffer siz 
the transmission of a block of data 120C 
HP 3000. The block of data would actu 
as follows. (DSN/DS appends an avera^ 


e is 512 words and that the user has initiated 
) words in length from his HP 3000 to a remote 
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I First physical transmission: 512 words 
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Figure 2-2. DSN/DS Line Buffer Example 



When you execute a DSLINE command, DSN/DS attempts to give you 
access to the specified communications line ajid, if successful, 
informs you of the assigned DS line number by displaying the 
following message at your terminal: 



DS LINE NUMBER = #Lx 



where x is the assigned DS line number. In the example in 
Section I, the DS line number "3" was assigned. The DS line 
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number is significant only if you open and use more than one 
communications line concurrently within a single local session 
(see "Opening Multiple Lines" later in this section). 

At this point you have acquired a physical communications line 
but the communications link does not yet exist. The actual 
communications link between the two computers is established by 
initiating a remote session over the line. You do this by 
executing a REMOTE HELLO command. In the example in Section I» 
the REMOTE HELLO command contained the minimum parameters 
required (a usemame and an accountname) , as follows: 



: REMOTE HELLO RUSER . RACCOUNT 



The communications link between the two HP 3000 computers now 
exists. 



Opening a Telephone Line 

A DSN/DS communications link can also be established over the 
public (dial-up) telephone network. In such a case, the informa- 
tion passed back and forth between the two computers travels over 
the same lines that are used for normal voice traffic. Each 
computer is interfaced to the telephone lines by way of a modem. 
(The terra "modem" is a contraction of MOdulator-DEModulator. ) A 
modem is a device that translates digital signals (electrical 
impulses) generated by a computer into analog signals (tones) 
that can be transmitted over telephone lines, eoid vice versa. 

The modem is connected to the HP 3000 Computer System by way of a 
communications interface. The communications interfaces used 
with modems include the HP 30010A, HP 30020A, and HP 30020B 
Intelligent Network Processor (INP), and the HP 30055A 
Synchronous Single-Line Controller (SSLC). (The HP 30010A INP is 
used with the HP 3000 Series II/III; the HP 30020A INP is used 
with the HP 3000 Series 30/33/1+0/J4U; the HP 30020B INP is used 
with the HP 3000 Series 30/33/U0/UU/6U; and the HP 30055A SSLC is 
used with the HP 3000 Series II/III.) Each INP or SSLC controls 
one modem (such as an HP 37210T, 37220T, or 37230A modem, or a 
Bell System Type 201, 208, or 209 modem) and is capable of both 
initiating and accepting a telephone connection with a remote 
computer over the public telephone network or a leased telephone 
line. 
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It is a little more complex to obtain access to a telephone line 
than to a hardwired line. Firsts you must identify the particu- 
lar communications interface (INP or SSLC) you wish to use. You 
do this by specifying the device class name or logical device 
nximber of the communication line that was associated during 
system configuration with the desired interface. You can use the 
DSLINE command for this purpose » as follows: 



:DSLINE SDSl 



In the DSLINE command, you may also wish to specify the size of 
the DSN/DS line buffer to be used in conjomction with the line. 
The size of this buffer determines the maximum sized block that 
can be sent or received in a single physical transmission over 
the line. Note that a transmission as you normally think of it 
(sending or receiving all or part of a file) may actually consist 
of many physical transmissions. In essence, this buffer size 
defines a blocking factor for the line. (Refer to figure 2-2.) 
A default buffer size is established during system configuration » 
and in most cases (as in the example in Section I), you will find 
it satisfactory to let this default value prevail. 

Next, you may wish to supply a set of identification (ID) 
sequences to be used in verifying that the desired pair of 
computers are connected to one another. This is discussed imder 
*'ID Sequences" later in this section. Briefly, however, you may 
supply an ID sequence that identifies your HP 3000 and one or 
more ID sequences that identify those remote computers with which 
your HP 3000 may validly be connected. When a telephone 
connection is established between your HP 3000 and a remote HP 
3000, the two computers exchange ID sequences and their validity 
detennines whether or not the connection is to remain in effect. 
You use the DSLINE command to supply ID sequences, as follows: 



:DSLINE SDSl ;LOCID="SYSTEM A" & 
;REMID="SYSTEM X" 



where SYSTEM A is the ID sequence identifying your HP 3000 and 
SYSTEM X is the ID sequence identifying the remote computer with 
which you want to establish a telephone connection. 

Again, there are default values that can be established during 
system configuration. In most cases, however, you will at least 
want to explicitly identify the desired remote HP 3000 to be 
certain that the proper connection is being established. 

Now you must establish the physical connection between the two 
computers by dialing (at the modem) the telephone number of the 
remote computer and responding (at the system console) to the 
dial request. If you wish to have the console operator of your 
HP 3000 dial the number for you, you may supply the desired 



2-5 



Opening a Line 



number in the DSLINE command and it will be displayed as part of 
a dial request message at the operator's console. In s 
case, you would supply the telephone number as follows: 



:DSLINE SDSl ;LOCID="SYSTEM A" & 
;REMID="SYSTEM X'* & 
;PHNUM=555-123i* 

If autodial equipment is installed on the SDSl line, the 
telephone number supplied in the DSLINE command is used instead 
of the number configured for the line. 

The various possibilities involved in establishing a telephone 
connection with a remote computer are discussed under "Dialing 
the Remote Computer" later in this section. 

When you execute the DSLINE command, DSN/DS attempts to give you 
access to the specified communications interface (INP or SSLC) 
and, if the telephone connection is successfully established, 
informs you of the assigned DS line number by displaying the 
following message at your terminal; 

DS LINE NUMBER = #Lx 

where x is the assigned DS line number. In the example in 
Section I, the DS line number '*3'* was assigned. The DS line 
number is significant only if you open and use more than one 
communications line concurrently within a single local session 
(see "Opening Multiple Lines" later in this section). 

At this point, you have acquired a physical communications line, 

but the communications link does not yet exist. The actual ^^^ 

communications link between the two computers is established by ^ 

initiating a remote session over the line. You do this by 

executing a REMOTE HELLO command. In the example in Section I, a 

REMOTE HELLO command was used that contained the minimum 

parameters required (a usemame and an accountname) , as follows: 

: REMOTE HELLO RUSER . RACCOUNT 

The communications link between the two HP 3000 computers now 
exists. 
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Specifying a Line 

As you have seen, in order to open either a hardwired communica- 
tions line or a dial-up telephone line, you must specify a device 
class name or logical device number identifying the particular 
comm\inication line that is associated with a specific INP, HSI, 
or SSLC that you wish to use. But how do you figure out which 
name or nxunber to specify? The remainder of this topic may seem, 
particularly at first reading, a little complex and tedious. In 
actual practice, however, once the hardware and software configu- 
ration is installed and usable, most DSN/DS sites will post a 
notice defining all of the available communications lines and the 
proper device class names and logical device nximbers for each. 
In that case, all of the detective work described in the follow- 
ing paragraphs is already done for you. 

For each communications interface, there is a pair of associated 
drivers. First, there is the actual INP, HSI, or SSLC driver 
that directly controls the operation of the interface board. In 
addition, there is a DSN/DS communications driver that controls 
the operation of the INP, HSI, or SSLC driver. The names of 
these drivers are as follows: 



lOINPO (INP driver) 

CSHBSCO (HSI driver) 

CSSBSCO (SSLC driver) 

lODSO (DSN/DS communications driver) 

lODSX (DSN/DS communications driver, while utilizing 
the X.25 capability) 



Now look at the appropriate sample I/O device table produced 
during system configuration (figure 2-3 for a hardwired line or 
figure 2-U for a telephone line). 
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In figure 2-3» the shaded items in the coliimn labeled "DRIVER 
NAME" shows four HSI lines (CSHBSCO) configured into the system 
as logical devices 12 through 15. For each one of these lines, 
there is a DSN/DS communications driver (in this case, lODSO) 
also configured into the system. Each lODSO (or lODSX) entry is 
related to the proper HSI (or INP) entry by the number specified 
in the column labeled "DRT" (the # prefix indicates a back refer- 
ence to a previously defined logical device number). Logical 
devices 50 through 53 are paired with logical devices 12 through 
15 > respectively. It is the device class name or logical device 
number of the appropriate lODSO entry (or logical node name for 
the lODSX entry) that you use to specify the desired line. 
(Refer to Appendix A) . 
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Figure 2-3* Sample I/O Device Table (Hardwired Line) 
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In figure 2-U, the shaded items in the column labeled ''DRIVER 
NAME'* shows one SSLC (CSSBSCO) configured into the system as 
logical device 13* Notice that there is a DSN/DS communications 
driver (in this case, lODSO) also configured into the system. 
The lODSO (or lODSX) entry is related to the proper SSLC (or INP) 
entry by the number specified in the column labeled "DRT" (the # 
prefix indicates a back reference to a previously defined logical 
device number). Logical device 6l is paired with logical device 
13* It is the device class name or logical device number of the 
appropriate lODSO entry (or logical node name for the lODSX 
entry) that you use to specify the desired line. 
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Figure 2-U. Sample I/O Device Table (Telephone Line) 
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If you have only one communications interface (INP, HSI, or SSLC) 
configured into your system, there is no question about which 
name or number to specify in a DSLINE command. If there is more 
than one communications interface, however, you must know (or ask 
someone tAo knows) which CSHBSCO, CSSBSCO, or lOINPO pertains to 
the physical line you want to use. 

One or more virtual terminal drivers (lODSTRMO or lODSTRMX) 
should also be configured into the system. The lODSTRMO or 
lODSTRMX entries allow users on another system to be logged on to 
this system and regulate the number of remote Session Main 
Processes (SMP) that can be assigned to a given line. Each 
lODSTRMO or lODSTRMX entry is related to the proper communica- 
tions interface entry by the number specified in the column 
labeled "DRT". Figure 2-3 (the hardwired example) shows logical 
devices 60 through 65 are paired with logical devices 12 through 
15; figure 2-U (the telephone line example) shows logical devices 
6k and 65 are paired with logical device 13* ^^^ 

In figure 2-3, notice that the HSI board entries (logical devices 
12 through 15) look the same except for the PORTMASK. The 
PORTMASK specifies which port on the board is to be used. There 
are also virtual terminals (logical devices 60 through 65) 
referencing back to logical device 12. 

Since only one port on the HSI board can be opened at a time, 

only one block of virtual terminal entries is needed for that ^^^^j^ 

board. As each port is opened individually by specifying the ^ 

corresponding DS entry in the :DSCONTROL command (see Appendix 
C), the system automatically reallocates the block of virtual 
terminal entries to the proper HSI board entry. This realloca- 
tion will not, however, show up in the I/O configuration table. 
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The DSLINE Command 



The format of the DSLINE command, as used to open a line, is 
presented in figure 2-5- In addition to opening a hardwired line 
or a telephone line, this command can also be used for closing 
one or more communications lines (discussed later in this 
section) • 



j^^ 



ijlf^. 
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:DSLINE 



dsdevice 



lX.m^B\}?=buffer-$ize] 

[ ;LOC I D=locaNd'Sequence ] 

[ ;R EM I D=remote-id-sequence | [/emote'id''Sequence2\ . 

[ f H H\JU=^elephone'number\ 

[;EXCLUSIVE] 

[,C0MP1 

[;NOCOMP] 

[^•QUIET] 



..] 



Figure 2-5* Opening a Line with the DSLINE Command 
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:DSLINE 



The parameters that pertain to opening either a hardwired 
coranmnications line or a telephone line are as follows: 



dsdevice 



This is the device class name or logical 
device number assigned to the DSN/DS communi- 
cations driver (lODSO) during system configu- 
ration, or a logical node name. This parame- 
ter specifies what physical hardwired line or 
what communications interface (and modem) you 
wish to use. 

(Required parameter.) 



NOTE 



DS/X.2^ users should always use a node 
name rather than a line identifier. 



buffer- size 



A decimal integer specifying the size (in 
words) of the DSN/DS line buffer to be used 
in conjimction with the communications line. 
The integer must be within the range 30U < 
buffer-size < 102U when used with the INP or 
within the range 30U < buffer-size < U095 
when used with the SSLC or HSI. The default 
value is the buffer size entered in response 
to the PREFERRED BUFFER SIZE prompt during 
system configuration. This parameter over- 
rides the MPE configured value when specified 
by the first user to open the given line. 

(Optional parameter.) 



--^^ 



EXCLUSIVE 



This parameter, if present, specifies that 
you want exclusive use of the comm\mi cat ions 
line. If the requested line or specified 
communications interface is already open and 
you have specified the EXCLUSIVE option, 
DSN/DS will deny you access to the line (you 
cannot open it). (See "Line Opening 
Failures" later in this section.) Opening an 
EXCLUSIVE line requires the user to have CS 
and ND capability. 

(Optional parameter.) 
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0^\ 



COMP 



By using this parameter, you can override the 
current system default « which was set at con- 
figuration time (see Appendix A) or set by 
the system operator (see Appendix C), and 
activate data compression. In this way, the 
mode of operation is set for your subsequent 
DS activity. This parameter does not affect 
other users sharing the line. 

(Optional parameter. ) 



NOCOMP 



1^^ 



QUIET 






This parameter deactivates the data compres- 
sion mode. 

(Optional parameter. ) 



When you issue the DSLINE command with this 
parameter added, the message identifying the 
DS line number is suppressed. The messages 
associated with the subsequent REMOTE HELLO 
and REMOTE BYE commands will also be sup- 
pressed. 

(Optional parameter. ) 



The additional parameters (shown in figure 2-5) that pertain only 
to opening a telephone line are as follows: 



jffi^ 



telephone -number 



^^. 



A telephone number consisting of digits and 
dashes. The maximum length permitted 
(including both digits and dashes) is 20 
characters. Provided that YES was entered in 
response to the DIAL FACILITY prompt during 
system configuration, this telephone number 
will be displayed at the operator's console 
of your HP 3000 and the operator will then 
establish the telephone connection by dialing 
that number at the modem. (When the autodial 
feature is present in your system, the number 
provided here is dialed automatically.) The 
default telephone number is the one entered 
in response to the PHONE NUMBER prompt during 
system configuration. 

(Optional parameter.) 
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local-id-sequence 



A string of ASCII characters contained within 
quotation marks or a string of octal numbers 
separated by commas and contained within 
parentheses. If you wish to use a quotation 
mark within an ASCII strings use two 
successive quotation marks. In the case of 
an octal sequence, each octal number 
represents one byte and must be within the 
range 0-377. The maxiraxira number of ASCII 
characters or octal niunbers allowed in the 
string is l6. 

The supplied string of ASCII characters or 
octal numbers defines the ID sequence that 
will be sent from your HP 3000 to the remote 
HP 3000 when you attempt to establish the 
telephone connection. If the remote HP 3000 
does not recognize the supplied ID sequence 
as a valid one, the telephone connection is 
terminated. The default value is the ASCII 
or octal string entered in response to the 
LOCAL ID SEQUENCE prompt during system 
configuration. 

(Optional parameter.) 



remote- id-sequence Same format as local- id-sequence. 

The supplied strings of ASCII characters or 
octal numbers define those remote HP 3000 ID 
sequences that will be considered valid when 
you attempt to establish the telephone 
coxmection. If the remote HP 3000 does not 
send a valid ID sequence, the telephone 
connection is terminated. The default set of 
remote ID sequences consists of the ASCII and 
octal strings entered in response to the 
REMOTE ID SEQUENCE prompt during system 
configuration. 

(Optional parameter.) 



NOTE 



The logical node name (mentioned in the dsdevice 
parameter description) appears in the configuration 
file for a Public Data Network (PDN). (See Appendix 
H.) A Remote Node (RN) table relates the logical 
node name (specified in this command) to the logical 
device number of the appropriate lODSX driver (the 
X.25 driver), and to the PDN address of the destination 
node. 



2-lU 



r 



^PN 



/^^^ 



Opening a Line 



Dialing the Remote Computer 

When you are opening a telephone line, you may supply a telephone 
number (as an optional parameter in the DSLINE command » see 
figure 2-5) to be dialed at the modem connected to the specified 
INP or SSLC, If you supply a telephone number, DSN/DS displays a 
message on the system console telling the operator to dial that 
number. The operator, after dialing the specified number, enters 
YES or NO through the system console =REPLy command to let DSN/DS 
know whether or not the telephone connection was successfully 
made. If the operator enters YES, DSN/DS proceeds with the 
exchanging of ID sequences. If the operator enters NO, your 
DSLINE request is denied (you cannot open the line). In either 
case, your terminal's keyboard is disabled \mtil the console 
operator responds. 

If you do not supply a telephone number, the sequence of events 
is as described in the above paragraph, except that DSN/DS uses 
(by default) the first telephone number in the PHONELIST 
established during system configuration. 

If you do not supply a telephone number and no PHONELIST was 
established during system configuration, an I/O request message 
is displayed at the system console, but it does not include the 
number to be dialed. This method might be used when you will 
dial the remote HP 3000 yourself. Remember, however, that the 
console operator must still know whether you dialed successfully, 
since he must respond to the console message before you are 
granted access to the line. Because your terminal's keyboard is 
disabled until the console operator responds with YES or NO, it 
is recommended that you always supply a telephone number in the 
DSLINE command. 
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ID Sequences 

Once a telephone connection to a remote HP 3000 exists, the two 
computers exchange ID sequences with one another. Within the 
context of DSN/DS; an ID sequence is a string of up to l6 ASCII 
characters or octal numbers that identifies a particular 
computer . 

During system configuration, each HP 3000 can be assigned a local 
ID sequence and a list of remote ID sequences. The local ID 
sequence identifies the particular HP 3000 in which it is 
established; the remote ID sequences identify those remote 
computers with which a communications link can be established 
over the public telephone network. 

In the DSLINE command, you can supply (as optional parameters) a 
local ID sequence and one or more remote ID sequences to be used ^.^^^ 

instead of those established during system configuration. (Refer ^] 

to figure 2-5. ) 

When a telephone connection is established between your HP 3000 
and a remote HP 3000, the local ID sequence supplied in your 
DSLINE command is transmitted to the remote system. The remote 
system compares that ID against its list of remote ID sequences. 
If that ID sequence is found to be valid, the remote system 
transmits its local ID sequence over the telephone line to your 
HP 3000. The received ID sequence is then compared against the 
remote ID sequence (s) supplied in your DSLINE command. If that 
ID sequence is found to be valid, the telephone connection is 
considered successful and DSN/DS grants you access to the line. 
If the ID sequence received at either end of the line is not 
considered valid, your DSLINE request is denied (you cannot open 
the line). 

If you do not supply any ID sequences, DSN/DS uses those /^s?^ 

established during system configuration. If no ID sequences were ) 

established during system configuration and you do not supply 

any, no local ID sequence is transmitted from your HP 3000 to the 

remote system and any remote ID sequence received is considered 

valid. 
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Opening a Line 

Multiple Users 

Within a DSN/DS environment, it is possible for several users at 
either end of the line to share access to the same physical 
communications line or for a single user at one end of the line 
to obtain exclusive access to the line. 

As previously mentioned in the presentation of the DSLINE com- 
mand, the EXCLUSIVE parameter can be used to obtain exclusive 
access to the specified physical commxmi cat ions line. If you 
specify this parameter (and if access to the line is granted) , no 
other user in either computer will be permitted to open that line 
until you close it. If you ask for exclusive access to a partic- 
ular line and that line is already in use, DSN/DS denies your 
request (you cainnot open the line). (See "Line Opening Failures" 
later in this section.) 

For hardwired lines and for dial-up lines, multiple users at 
either end of the line can specify the same physical line in 
DSLINE commands and obtain access to that line as long as none of 
them requests exclusive access. In such a case, the users' data 
is multiplexed, so that each user's access to the line appears to 
be completely independent of all others. The exception for a 
telephone line is that all users, other than the one who 
originally opened the line, specify (explicitly or by default) 
the currently active remote ID sequence. Figures 2-6 through 
2-21 present annotated examples, illustrating successful and 
unsuccessful attempts by different users to obtain access to the 
same line. 
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SYSTEM A 



SYSTEM B 



LOCAL 
SESSION /"---.. 



LOCAL 
SESSION 



HDS1 



>- 
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\ 



UserX 





UserY 



: HELLO USER.X 

iDSLINE HDSl 

: REMOTE HELLO USER.X 



: HELLO USER.Y 

:DSLINE HDSl 

: REMOTE HELLO USER.Y 



In this example. User X initiates a local session in System 
A, obtains access to the hardwired communications line that 
connects System A to System B, and initiates a remote 
session in System B, User 7 subsequently initiates a local 
session in System A, obtains access to the same commiinica- 
tions line, and initiates a remote session in System B. The 
request by User Y for the particular communications line is 
granted by DSN/DS because neither user asked for exclusive 
access to the line* 



/^ 



Figure 2-6. Multiple User Exatmple 1 



2-18 



Opening a Line 



J^^ 



SYSTEM A 



SYSTEM B 



LOCAL 
SESSION A--. 



#P^ 



REMOTE 
SESSION 



HDS1 



HDS2 



UserX 
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:HELLO USER^X 

:DSLINE HDSl 

: REMOTE HELLO USER.X 



: HELLO USER.Y 

:DSLINE HDS2 

: REMOTE HELLO USER.Y 



In this example. User X initiates a local session in System 
A, obtains access to the hardwired communications line that 
connects System A to System B, and initiates a remote 
session in System B. User Y subsequently initiates a local 
session in System B, obtains access to the same communica- 
tions line, and initiates a remote session in System A. The 
request by User Y for the particular communications line is 
granted by DSN/DS because neither user asked for exclusive 
access to the line. 



^^ 



Figure 2-7 • Multiple User Example 2 
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SYSTEM A 



SYSTEM B 
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: HELLO USER.X 

:DSLINE HDSl ;EXCLUSIVE 

: REMOTE HELLO USER.X 



: HELLO USER.Y 
:DSLINE HDSl 



In this example, User X initiates a local session in System 
A, obtains exclusive access to the hardwired communications 
line that connects System A to System B, and initiates a 
remote session in System B. User Y subsequently initiates a 
local session in System A and requests access to the same 
communications line. The request is denied by DSN/DS 
because User X already has exclusive access to the specified 
line. 



Figure 2-8. Exclusive Option Example 1 
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SYSTEM A 



SYSTEM B 



LOCAL 

.SESSION y^-- — . 



HDS1 



HDS2 




UserX 



r 




UserY 




: HELLO USER.X 

:DSLINE HDSl ; EXCLUSIVE 

.•REMOTE HELLO USER.X 



: HELLO USER.Y 
:DSLINE HDS2 



In this example, User X initiates a local session in System 
A, obtains exclusive access to the hardwired communications 
line that connects System A to System B, and initiates a 
remote session in System B, User Y subsequently initiates a 
local session in System B and requests access to the same 
communications line. The request is denied by DSN/DS 
because User X already has exclusive access to the specified 
line. 



Figure 2-9. Exclusive Option Example 2 
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SYSTEM A 



SYSTEM B 
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: HELLO USER.X 

:DSLINE HDSl 

: REMOTE HELLO USER.X 



: HELLO USER.Y 

:DSLINE HDSl ;EXCLUSIVE 



In this example. User X initiates a local session in System 
A, obtains access to the hardwired communications line that 
connects System A to System B, and initiates a remote 
session in System B. User Y subsequently initiates a local 
session in System A and requests exclusive access to 
the same communications line. The request is denied by 
DSN/DS because the specified line is already in use and 
therefore cannot be assigned exclusively to User Y. 



Figure 2-10. Exclusive Option Example 3 
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SYSTEM A 



SYSTEM B 




HDS1 



HDS2 



f 



■i 




UserX 




User Y 




HELLO USER.X 

DSLINE HDSl 

REMOTE HELLO USER.X 



: HELLO USER.Y 

: DSLINE HDS2 ;EXCLUSIVE 



In this example, User X initiates a local session in System 
A, obtains access to the hardwired communications line that 
connects System A to System B, and initiates a remote 
session in System B, User Y subsequently initiates a local 
session in System B and requests exclusive access to 
the same* communications line« The request is denied by 
DSN/DS because the specified line is already in use and 
therefore cannot be assigned exclusively to User Y. 



Figure 2-11. Exclusive Option Example U 
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Configured Local ID: A 
Configured Remote IDs: B^C 



Configured Local ID: B 
Configured Remote IDs: A,C 



SYSTEM A 



SYSTEM B 



LOCAL 
^ESSION T^---^. 




: HELLO USER.X 
:DSLINE SDSl & 

;PHNUM=555-123»* & 
;REMID="B" 
: REMOTE HELLO USER.X 



: HELLO USER.Y 
:DSLINE SDSl & 

;PHNUM=555-123U fc 

;REMID="B" 
: REMOTE HELLO USER.Y 



In this example User X initiates a local session in System A 
and obtains access to the line identified by the device class 
name SDSl. The supplied telephone number is displayed at the 
system console of System A. The console operator establishes 
the telephone connection by dialing the number at the modem 
connected to the particular line and then enters "YES" through 
the system console to let DSN/DS know that the telephone 

(continued) 
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Figure 2-12. Dial-up Line Multiple User Example 1 
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connection was successfully made. The two computers exchange 
their configured local ID sequences. System A compares the 
received ID sequence (B) against the remote ID sequence 
specified by User X (REMID=**B") and System B compares the 
received ID sequence (A) against its list of configured remote 
ID sequences (AfC). Since the received ID sequences are foxind 
to be valid at both ends of the line, the telephone connection 
is allowed to remain in effect. User X then initiates a 
remote session in System B over the telephone line from his 
local log-on terminal. 

User Y subsequently initiates a local session in System A and 
requests access to the same line (SDSl). Since that line is 
already open, DSN/DS ignores the supplied telephone number (no 
message is displayed at the system console). Access to the 
currently opened line is granted to User Y because neither 
user requested exclusive access ajid User Y specified the 
currently active remote ID sequence (REMID="B") in his DSLINE 
command • 



Figure 2-12, 



Dial-up Line Multiple User Example 1 
(Continued) 
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Configured Local ID: A 
Configured Remote IDs: B,C 



Configured Local ID: B 
Configured Remote IDs: A,C 



SYSTEM A 



SYSTEM B 




SDS1 



SDS3 
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UserX 





: HELLO USER.X 
:DSLINE SDSl & 

;PHNUM=555-123U & 
;REMID="B" 
: REMOTE HELLO USER.X 



: HELLO USER.T 
:DSLINE SDS3 & 

;PHNUM=777-U321 k 

;REMID="A" 
: REMOTE HELLO USER.Y 



In this example User X initiates a local session in System A 
and obtains access to the line identified by the device class 
name SDSl. The supplied telephone number is displayed at the 
system console of System A. The console operator establishes 
the telephone connection by dialing the number at the modem 
connected to the particular line and then enters "YES" through 
the system console to let DSN/DS know that the telephone 

(continued) 



Figure 2-13. Dial-up Line Multiple User Example 2 
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connection was successfully made* The two computers exchange 
their configured local ID sequences* System A compares the 
received ID sequence (B) against the remote ID sequence 
specified by User X (REMID="B") and System B compares the 
received ID sequence (A) against its list of configured remote 
ID sequences (A^C). Since the received ID sequences are found 
to be valid at both ends of the line« the telephone connection 
is allowed to remain in effect. User X then initiates a 
remote session in System B over the telephone line from his 
local log-on terminal. 



^^s, 



User 7 subsequently initiates a local session in System B 
and requests access to the line identified by the device 
class name SDS3. Since that line is already open, DSN/DS 
ignores the supplied telephone number (no message is 
displayed at the system console). Access to the currently 
opened line is granted to User Y because neither user re- 
quested exclusive access and User Y specified the currently 
active remote ID sequence (REMID="A*') in his DSLINE command. 



Figure 2-13. 



Dial-up Line Multiple User Example 2 
(Continued) 
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Configured Local ID: A 
Configured Remote IDs: B,C 



Configured Local ID: B 
Configured Remote IDs: A,C 



SYSTEM A 



SYSTEM B 



SDS1 

I — II — 




ih=^ 



REMOTE 
.SESSION 




: HELLO USER.X 

:DSLINE SDSl & 

;PHNUM=555-123U & 
;REMID="B" & 
;EXCLUSIVE 

: REMOTE HELLO USER.X 



: HELLO USER.Y 
:DSLINE SDSl & 

;PHNUM=555-123U t 

;REMID="B" 



In this example User X initiates a local session in System A 
and obtains exclusive access to the line identified by the 
device class name SDSl (he is granted access to it because 
at the time no one else was using that line). The supplied 
telephone ntunber is displayed at the system console of 
System A. The console operator establishes the telephone 

(continued) 
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Figure 2-lU. Dial-up Line Multiple User Example 3 
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connection by dialing the number at the modem connected 
to the particular line and then enters **YES" through the 
system console to let DSN/DS know that the telephone con- 
nection was successfully made. The two computers exchange 
their configured local ID sequences. System A compares the 
received ID sequence (B) against the remote ID sequence 
specified by User X (REMID="B*') and System B compares the 
received ID sequence (A) against its list of configured re- 
mote ID sequences (A,C). Since the received ID sequences are 
found to be valid at both ends of the line, the telephone 
connection is allowed to remain in effect* User X then ini- 
tiates a remote session in System B over the telephone line 
from his local log -on terminal. 



r 



User 7 subsequently initiates a local session in System A 
and requests access to the same line (SDSl). The request 
is denied by DSN/DS because the specified line is already 
open and User X has exclusive access to it. 
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Figure 2-lU. 



Dial-up Line Multiple User Example 3 
(Continued) 
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Configured Local ID: A Configured Local ID: B 
Configured Remote IDs: B,C Configured Remote IDs: A,C 



SYSTEM A 



SYSTEM B 




SDS1 



SDS3 



=7/=1 




UserX 




UserY 




: HELLO USER.X 

:DSLINE SDSl & 

;PHNUM=555-123U & 
;REMID="B" fc 
; EXCLUSIVE 

: REMOTE HELLO USER.X 



: HELLO USER. 7 
:DSLINE SDS3 & 

;PHNUM=777-U321 & 

;REMID="A" 



In this example User X initiates a local session in System A 
and obtains exclusive access to the line identified by the 
device class name SDSl (he is granted access to it because 
at the time no one else was using that line) . The supplied 
telephone number is displayed at the system console of 
System A. The console operator establishes the telephone 

(continued) 



Figure 2-15 . Dial-up Line Multiple User Example U 
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connection by dialing the number at the modem connected 
to the particular line and then enters "YES" through the 
system console to let DSN/DS know that the telephone con- 
nection was successfully made. The two computers exchange 
their configured local ID sequences. System A compares the 
received ID sequence (B) against the remote ID sequence 
specified by User X (REMID="B") and System B compares the 
received ID sequence (A) against its list of configured re- 
mote ID sequences (A^C). Since the received ID sequences are 
found to be valid at both ends of the line, the telephone 
connection is allowed to remain in effect. User X then ini- 
tiates a remote session in System B over the telephone line 
from his local log-on terminal. 

User Y subsequently initiates a local session in System B 
and requests access to the line identified by the device 
class name SDS3. The request is denied by DSN/DS because 
the specified line is already open and User X has exclusive 
access to it. 



Figure 2-15. Dial-up Line Multiple User Example U 
(Continued) 
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Configured Local ID: A Configured Local ID: B 
Configured Remote IDs: B,C Configured Remote IDs: A,C 



SYSTEM A 



SYSTEM B 




SDS1 



REMOTE 
SESSION 



X 
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UserX 



UserY 





:HELLO USER.X 
:DSLINE SDSl & 

;PHNUM=555-123U & 

;REMID="B" 
: REMOTE HELLO USER.X 



: HELLO USER. 7 

:DSLINE SDSl & 

;PHNUM=555-123H «c 
;REMID="B" fc 
; EXCLUSIVE 



In this example User X initiates a local session in System A 
and obtains access to the line identified by the device class 
name SDSl. The supplied telephone number is displayed at the 
system console of System A. The console operator establishes 
the telephone connection by dialing the number at the modem 
connected to the particular line and then enters "YES" through 
the system console to let DSN/DS know that the telephone 

(continued) 
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Figure 2-l6. Dial-up Line Multiple User Example 5 
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connection was successfully made. The two computers exchange 
their configured local ID sequences • System A compares the 
received ID sequence (B) against the remote ID sequence 
specified by User X (REMID="B") and System B compares the 
received ID sequence (A) against its list of configured remote 
ID sequences (A,C), Since the received ID sequences are found 
to be valid at both ends of the line, the telephone connection 
is allowed to remain in effect. User X then initiates a 
remote session in System B over the telephone line from his 
local log-on terminal. 

User Y subsequently initiates a local session in System A 
and requests exclusive access to the same line (SDSl). 
The request is denied by DSN/DS because the specified line 
is already open and therefore cannot be assigned exclusively 
to User Y. 



Figure 2-l6. 



Dial-up Line Multiple User Example 5 
(Continued) 
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Configured Local ID: A Configured Local ID: B 

Configured Remote IDs: B,C Configured Remote IDs: A,C 



SYSTEM A 



SYSTEM B 



LOCAL 

SESSION y-^-.^. 



SDS1 



SDS3 
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UserX 





:HELLO USER.X 
:DSLINE SDSl & 

;PHNUM=555-123U & 

;REMID="B" 
: REMOTE HELLO USER.X 



: HELLO USER. 7 

:DSLINE SDS3 & 

;PHNUM=777-U321 & 
;REMID="A" & 
; EXCLUSIVE 



In this example User X initiates a local session in System A 
and obtains access to the line identified by the device class 
name SDSl. The supplied telephone niunber is displayed at the 
system console of System A. The console operator establishes 
the telephone connection by dialing the niunber at the modem 
connected to the particular line and then enters "YES" through 
the system console to let DSN/DS know that the telephone 

(continued) 



Figure 2-17. Dial-up Line Multiple User Example 6 
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connection was successfully made* The two computers exchange 
their configured local ID sequences. System A compares the 
received ID sequence (B) against the remote ID sequence 
specified by User X (REMID='*B") and System B compares the 
received ID sequence (A) against its list of configured remote 
ID sequences (A,C). Since the received ID sequences are found 
to be valid at both ends of the line^ the telephone connection 
is allowed to remain in effect. User X then initiates a 
remote session in System B over the telephone line from his 
local log-on terminal. 



User 7 subsequently initiates a local session in System B 
and requests exclusive access to the line identified by 
the device class name SDS3. The request is denied by DSN/DS 
because the specified line is already open and therefore 
cannot be assigned exclusively to User 7. 
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Figure 2-17. 



Dial-up Line Multiple User Example 6 
(Continued) 
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Configured Local ID: A 
Configured Remote IDs: B,C 



Configured Local ID: B 
Configured Remote IDs: A,C 



SYSTEM A 



SYSTEM B 



LOCAL 
SESSION /^--^^ 



SDS1 



REMOTE 
SESSION 




: HELLO USER.X 
:DSLINE SDSl fc 

;PHm]M=555-123U & 

;REMID="B" 
: REMOTE HELLO USER.X 



:HELLO USER.Y 
:DSLINE SDSl & 

;PHNUM=555-2001 & 

;REMID="C" 



In this example User X initiates a local session in System A 
and obtains access to the line identified by the device class 
name SDSl* The supplied telephone number is displayed at the 
system console of System A* The console operator establishes 
the telephone connection by dialing the number at the modem 
cozmected to the particular line and then enters "YES" through 
the system console to let DSN/DS know that the telephone 

(continued) 



Figure 2-18. Dial-up Line Multiple User Example 7 
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connection was successfully made. The two computers exchange 
their configured local ID sequences • System A compares the 
received ID sequence (B) against the remote ID sequence 
specified by User X (REMID='*B") and System B compares the 
received ID sequence (A) against its list of configured remote 
ID sequences (A,C)» Since the received ID sequences are found 
to be valid at both ends of the line, the telephone connection 
is allowed to remain in effect. User X then initiates a 
remote session in System B over the telephone line from his 
local log-on terminal* 

User Y subsequently initiates a local session in System A 
and requests access to the same line (SDSl). The request 
is denied by DSN/DS because the specified line is already 
open and User Y did not specify the currently active remote 
ID sequence (B) in his DSLINE command. 



Figure 2-l8. 



Dial-up Line Multiple User Example 7 
(Continued) 
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Configured Local ID: A Configured Local ID: B 
Configured Remote IDs: B,C Configured Remote IDs: A»C 



SYSTEM A 



SYSTEM B 



LOCAL 
SESSION y^--*^ 



SDS1 



SDS3 



^=^/=^ 



UserX 





: HELLO USER.X 
:DSLINE SDSl te 

;PHNUM=555-123U & 

;REMID="B" 
: REMOTE HELLO USER.X 



: HELLO USER.Y 
:DSLINE SDS3 & 

;PHNUM=555-2001 fc 

;REMID="C" 



In this example User X initiates a local session in System A 
and obtains access to the line identified by the device class 
name SDSl. The supplied telephone niunber is displayed at the 
system console of System A. The console operator establishes 
the telephone connection by dialing the number at the modem 
connected to the particular line and then enters "YES" through 
the system console to let DSN/DS know that the telephone 

(continued) 



Figure 2-19. Dial-up Line Multiple User Example 8 
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/^^' 



connection was successfully made. The two computers exchange 
their configured local ID sequences. System A compares the 
received ID sequence (B) against the remote ID sequence 
specified by User X (REMID="B'*) and System B compares the 
received ID sequence (A) against its list of configured remote 
ID sequences (A,C)* Since the received ID sequences are found 
to be valid at both ends of the line» the telephone connection 
is allowed to remain in effect. User X then initiates a 
remote session in System B over the telephone line from his 
local log-on terminal. 

User Y subsequently initiates a local session in System B 
and requests access to the line identified by the device 
class name SDS3* The request is denied by DSN/DS because 
the specified line is already open and User Y did not 
specify the currently active remote ID sequence (A) in his 
DSLINE command. 



Figure 2-19. 



Dial-up Line Multiple User Example 8 
(Continued) 
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Configured Local ID: (none) Configured Local ID: (none) 
Configured Remote IDs: (none) Configured Remote IDs: (none) 



SYSTEM A 



SYSTEM B 




SDS1 



)-=^/==^Z 




\ 



\ 



\ 



\ 



\ 



\ 



\ 



\ 



UserX 



N 



UserY 





: HELLO USER.X 

:DSLINE SDSl ;PHNUM=555-123U 

: REMOTE HELLO USER.X 



: HELLO USER.T 

:DSLINE SDSl ;PHNUM=555-123'* 

iREMOTE HELLO USER.Y 



In this example User X initiates a local session in System A 
and obtains access to the line identified by the device class 
name SDSl. The supplied telephone number is displayed at the 
system console of System A. The console operator establishes 
the telephone connection by dialing the number at the modem 
connected to the particular line and then enters "YES" through 
the system console to let DSN/DS know that the telephone 
connection was successfully made. No ID sequences are 
exchanged because none were established (in either HP 3000) 

(continued) 
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Figure 2-20. Dial-up Line Multiple User Example 9 
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^^\ 



during system configuration and User X didn't specify any in 
his DSLINE command. User X then initiates a remote session in 
System B over the telephone line from his local log-on 
terminal. 



/^^ 
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User Y subsequently initiates a local session in System A and 
requests access to the same line (SDSl). Since that line is 
already open, DSN/DS ignores the supplied telephone number (no 
message is displayed at the system console). Access to the 
currently opened line is granted to User Y because neither 
user requested exclusive access and User Y specified the 
currently active remote ID sequence (in this case none) in his 
DSLINE command* 



r 



Note that idien no ID sequences are configured and the users 
don't supply any in their DSLINE commands, both are taking it 
on faith that they are connected to the proper remote 
computer. The total absence of configured or supplied ID 
sequences is safe only under very controlled circumstances. 
It is strongly recommended that all computers in a DSN/DS 
network that are capable of communicating over telephone lines 
have default local and remote ID sequences established during 
system configuration and that all line users specify the ID 
sequence of the desired remote computer (REMID==x) in their 
DSLINE commands. 



Figure 2-20. 



Dial-up Line Multiple User Example 9 
(Continued) 
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Configured Local ID: (none) Configured Local ID: (none) 
Configured Remote IDs: (none) Configured Remote IDs: (none) 



SYSTEM A 



SYSTEM B 



LOCAL 
SESSION y--^^ 



REMOTE 
SESSION 



SDS1 



SDS3 



z^==^A^=4: 



UserX 





•-^^ 



/^ 



HELLO USER.X 

DSLINE SDSl ;PHNUM=555-123U 

REMOTE HELLO USER.X 



: HELLO USER.! 

:DSLINE SDS3 ;PHNUM=777-U321 

:REMOTE HELLO USER.Y 



In this example User X initiates a local session in System A 
and obtains access to the line identified by the device class 
name SDSl. The supplied telephone number is displayed at the 
system console of System A. The console operator establishes 
the telephone connection by dialing the number at the modem 
connected to the particular line and then enters "YES" through 
the system console to let DSN/DS know that the telephone 
connection was successfully made. Ho ID sequences are 
exchanged because none were established (in either HP 3000) 

(continued) 
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during system configuration and User X didn't specify any in 
his DSLINE command. User X then initiates a remote session 
in System B over the telephone line from his local log-on 
terminal* 



j*|p^*N 



^m^S, 



User 7 subsequently initiates a local session in System B 
and requests access to the line identified by the device 
class name SDS3* Since that line is already open, DSN/DS 
ignores the supplied telephone number (no message is 
displayed at the system console)* Access to the currently 
opened line is granted to User Y because neither user re- 
quested exclusive access and User Y specified the currently 
active remote ID sequence (in this case none) in his DSLINE 
command • 



j^^\ 



Note that ^dien no ID sequences are configured and the users 
don't supply any in their DSLINE commands, both are taking 
it on faith that they are connected to the proper remote 
computer* The total absence of configxired or supplied ID 
sequences is safe only under very controlled circumstances* 
It is strongly recommended that all computers in a DSN/DS 
network that are capable of communicating over telephone 
lines have default local and remote ID sequences established 
during system configuration and that all line users specify 
the ID sequence of the desired remote computer (REMID=x) in 
their DSLINE commands* 



Figure 2-21. 



Dial-up Line Multiple User Example 10 
(Continued) 
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:REMOTE HELLO 

The REMOTE HELLO Command '^ 

Once you have obtained access to a physical communications line 
using the DSLINE command, you use the REMOTE HELLO command to 
actually establish the communications link. The REMOTE HELLO 
command initiates a remote session on your behalf in the HP 3000 
connected to the other end of the communications line. 

The format of the REMOTE HELLO command is presented in figure 
2-22. Notice that, except for the three shaded items, it has 
exactly the same format as the standard MPE HELLO command. 

Because the REMOTE HELLO command is initiating a session for you 
in a remote HP 3000, the parameters in that command specify 
information which pertains to the operating environment of the 
remote HP 3000 (not your local one). More specifically you must 
keep the following in mind: 

• sessionname (if present) identifies the remote session and 
has no relationship to your local session. 

• usemame, accountname, groupname, and their passwords (if 
any) must all be valid as defined by the accounting struc- 
ture of the remote HP 3000. 

• cpusecs (if present) refers to central-processor time in 
the remote system. 

• BS, CS, DS, ES, inputpriority, and HIPRI (if present) all 
specify priorities for the remote session within the remote 
system. 

• termtj^e (if present) has no meaning and is ignored 
because output from the remote session is directed 
to the commtini cat ions line instead of to a terminal. 
The termtype parameter for your local session implicitly 
defines your log-on terminal type for any remote sessions 
that you initiate. 
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:REMOTE HELLO 



^^v 



HELLO [sessionname,] usemame [/userpass] .acctname [/acctpass] 

[^roupname l/grouppass] ] 



%^§Mm^§m^^mfi 


[;TIME = cpusecs] 




fBS] 




[;PRI=. 


CS 

DS 

^ES^ 


■] 


';INPRI 
:HIPRI 


= inputpriority 






yj^^ 



Figure 2-22. The REMOTE HELLO Command Syntax 



The parameters for the REMOTE HELLO command are as follows: 



i^p^ 



sessionnaone 



Arbitrary name used in conjunction with 
usemame and acctname paretmeters to form a 
session identity. Contains from 1 to 8 
alphanumeric characters, beginning with a 
letter. Default is that no session name is 
assigned. 



usemame 



^^\ 



A user name, established by the account 
manager, that allows you to log on under this 
accotmt. Contains from 1 to 8 alphanumeric 
characters, beginning with a letter* 

(Required parameter. ) 
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userpass 



User password, optionally assigned by the 
account manager. Contains from 1 to 8 alpha- 
numeric characters, beginning with a letter. 



acctname 



Name of account, as established by the 
account manager. Contains from 1 to 8 alpha- 
numeric characters, beginning with a letter. 
The acctname parameter must be preceded by a 
period. 

(Required parameter.) 



acctpass 



groupname 



Account password, optionally assigned by the 
system manager. Contains from 1 to 8 alpha- 
numeric characters, beginning with a letter. 



Name of the group to be used for local file 
domain and CPU time charges. Established by 
the account manager. Contains from 1 to 8 
alphanumeric characters, beginning with a 
letter. Default is your home group, if you 
are assigned one by the account manager. 

(Optional if you have a home group; required 
if a home group has not been assigned.) 



.z**^^ 
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grouppass 



Group password, optionally assigned by the 
accoimt manager. Contains from 1 to 8 alpha- 
numeric characters, begizming with a letter. 

(Required if assigned and you are logging on 
under other than your home group; optional if 
you are logging on under your home group.) 



termtype 



Ignored. The TERM=termtype parameter of the 
HELLO command that initiated the local 
session also implicitly defines the log-on 
terminal type for any remote sessions 
initiated from the local session. 



cpusecs 



Maximum CPU time that the session can use, 
entered in seconds. When the limit is 
reached, the session is aborted. Must be a 
value from 1 to 3276? • To specify no limit, 
enter a question mark (?) or UNLIM, or omit 
the parameter. Default is no limit. 



-''^ 
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r 



BS, CS» DS, ES 



Execution priority class. BS is highest 
priority; ES is lowest. If you specify a 
priority that exceeds the highest permitted 
for your accoxmt or user name by the system, 
MPE assigns the highest priority possible 
below BS. Default is CS. 



NOTE 



DS and ES are used primarily for 
batch jobs. Their use for sessions 
is discouraged. 



inputpriorty 



/^^. 



HIPRI 



r 



Relative input priority used in checking 
against access restrictions imposed by the 
jobfence, if one exists. Takes effect at 
log-on time. Must be a value from 1 (lowest 
priority) to 13 (highest priority). If a 
value is specified that is less than or equal 
to current jobfence set by the console 
operator, the session is denied access. 
Default is 8 or 13, depending upon the System 
Logging options in effect. 



Request for maximum session-selection input 
priority, causing the session to be scheduled 
regardless of current jobfence or execution 
limit for sessions. This parameter can be 
specified only by users with System Manager 
or System Supervisor capability. (If not, 
the system tries to log you on with INPRI= 
13.) Default is the current jobfence and 
execution limit. 



dsdevice 



The device class name or logical device 
number assigned to the DSN/DS communications 
driver (lODSO or lODSX) during system config- 
uration. This parameter, if present, 
specifies which line you wish to use. 

(Optional parameter if a line is already 
open; otherwise it is required.) 
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Opening a Line 



So far« we have been talking entirely about the DSLINE and REMOTE 
HELLO commands being used in conjunction with one another: the 
DSLINE command obtaining access to a physical line and the REMOTE 
HELLO command actually establishing the communications link by 
initiating a remote session over the acquired line. As you may 
have guessed from the above parameter definitions, the DSLINE 
parameter of the REMOTE HELLO command gives you a new, and 
simpler, way to obtain a line and establish a communications 
link. If you are satisfied to use the default DSN/DS line buffer 
size and you do not need exclusive use of the line, you can 
acquire a line and initiate a remote session over that line by 
using a single command: a REMOTE HELLO command with the DSLINE 
parameter. If you open a line in this way, however, it remains 
open only for the duration of the particular remote session (when 
the remote session is terminated the line is automatically 
closed). If, on the other hand, you use the DSLINE command to 
open a line, the line remains open for the duration of the local 
session (or until you explicitly close the line) . 



To illustrate this, look again at the example in Section I. In 
that example, the DSLINE command was used to obtain access to the 
hardwired line HDS2 and the REMOTE HELLO command was used to 
initiate a remote session over the line: 



: DSLINE HDS2 

REMOTE HELLO RUSER.RACCOUNT 

.HP3000 / MPE IV C.OO.OU. WED, MAR 3, 1982, 9:08 AM 
WELCOME TO SYSTEM B. 



NOTE 



In this case the 
acquired line re- 
mains open when the 
remote session is 
terminated. 
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By including the DSLINE parameter in the REMOTE HELLO command, 
essentially the same operations could be performed while using a 
single command , as follows: 



; REMOTE HELLO RUSER.RACC0UNT;DSLINE=HDS2 

DS LINE NUMBER = #L3 

HP3000 / MPE IV C.OO.OU. WED, MAR 3» 1982, 9:08 AM 

WELCOME TO SYSTEM B. 



NOTE 



In this case the 
acquired line is 
closed when the 
remote session is 
texminated. 



Another example, this time using the DSLINE command to obtain 
access to a telephone line (by way of an SSLC whose associated 
communications driver's device class name is SDSl) and the REMOTE 
HELLO command to initiate a remote session over the line, is as 
follows : 



; DSLINE SDSl 

DS LINE NUMBER = #L3 

; REMOTE HELLO RUSER.RACCOUNT 

HP3000 / MPE IV C.OO.OU. WED, MAR 3. 1982, 9:08 AM 

WELCOME TO SYSTEM B. 



NOTE 



In this case the 
acquired line re- 
mains open when the 
remote session is 
terminated. 
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By including the DSLINE parameter in the REMOTE HELLO command « 
you can perform essentially the same operations using a single 
command, as follows: 



: REMOTE HELLO RUSER>RACC0I1T;DSLINE=SDS1 

DS LINE NUMBER = #L3 

HP3000 / MPE IV C.OO.OU. WED, MAR 3* 1982, 9:08 AM 

WELCOME TO SYSTEM B. 



NOTE 



In this case the 

acquired line is 

closed irtien the ^^^ 

remote session is ^ 

terminated. 



This telephone line example will work properly for you only under 
veiy limited circumstances: 

• You must be satisfied to use the default DSN/DS line buffer '""^ 
size established during system configuration. ^ 

• The default ID sequences established in both computers during 
system configuration must properly identify both your local HP 
3000 and the desired remote HP 3000 (or no ID sequences were 
established during system configuration in either computer). 

• You must dial the remote computer yourself at the proper 
modem, or the line must be connected to (and configured for) 
autodialing. Note that if you cannot successfully make the 
telephone connection you cannot abort the REMOTE HELLO com- 
mand; the command will be rejected by DSN/DS if no connection 
is established within 13 minutes. 

The likelihood of all of the above conditions existing for a 
particular use of DSN/DS is rather slim. In most DSN/DS environ- 
ments you will want to explicitly define the ID sequence of the 
desired remote computer to guarantee that the proper connection 
is established, and you will want to provide a telephone nvimber 
so that you can let DSN/DS know immediately if a telephone con- 
nection cannot be made. (It is not acceptable to tie up a com- 
munications interface and your log-on terminal for 15 minutes 
waiting for an unsuccessful DSLINE or REMOTE HELLO request to be 
rejected.) 



■^ 
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Opening a Line 

Opening Multiple Lines 

Within your local session, you caoi open more than one physical 
comnunications line and you can have remote sessions active 
concurrently over all of the opened lines. However, when 
operating without DS/X.25 capability, you are limited to one 
remote session per physical line at any given time. 

If access to the specified line is obtained, DSN/DS responds to 
each DSLINE command by displaying a DS line number at your log-on 
terminal. This line number is roughly analagous to the file 
number returned by the MPE FOPEN intrinsic, in that it is an 
arbitrary number that uniquely identifies (within your local 
session) your current access to a particular communications line. 
It has no relationship to the logical device number or any other 
configuration parameter associated with the line. DS line 
numbers are meaningful only if you have more than one line open 
concurrently within a single local session. In that case, you 
are assigned a separate DS line number for each line you have 
opened, and you subsequently use these numbers to specify which 
line you wish to use for a given remote command (or sequence of 
remote commands) or to close a particular line without closing 
the others. 

Figure 2-23 illustrates a situation where a user has established 
two hardwired communications links concurrently from within a 
single local session. Take a closer look at that situation and 
examine the sequence of commands that was used to create it. 
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SYSTEM A 



HDS1 

(DS line number 3) 



SYSTEM B 




^^^ 
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Figure 2-23* Multiple Line Example (Hardwired Lines) 



2-52 






/pN 



j^P^ 



^^^\ 



Opening a Line 



First the user sat down at a terminal connected to System A and 
initiated a local session: 



: HELLO USER. ACCOUNT 

HP3000 / MPE IV C.OO.OU. WED, MAR 3, 1982, 1:37 PM 

WELCOME TO SYSTEM A. 



USER and ACCOUNT are valid user and account names, respectively, 
as defined by the accounting structure of System A. 

Now, we have the situation illustrated in figure 2-21+. Notice 
that, at this point, no communications link exists between any of 
the three systems* 
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SYSTEM A 



HDS1 



User's Log-On Terminal 



SYSTEM B 




SYSTEM C 



Figure 2-2U. Initiating the Local Session 
(Hardwired Example) 
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Next, the user acquired access to a line between Systems A and B 
and initiated a remote session in System B: 



; DSLINE HDSl 

DSLINE NUMBER ^ #L3 

; REMOTE HELLO RUSER . RACCOUNT 

HP3000 / MPE IV C.OO.OU. WED, MAR 3, 1982, 1:38 PM 

WELCOME TO SYSTEM B, 



HDSl is the device class name (as defined within System A) 
associated with the particular line. RUSER and RACCOUNT are 
valid user and account names, respectively, as defined by the 
accounting structure of System B, 



Now we have the situation illustrated in figure 2-25. 
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SYSTEM A 



/ 



HDS1 

(DS line number 3) 



SYSTEM B 



-]^™— ^-- 




REMOTE 
SESSION ^ 



SYSTEM C 



User's Log-On Terminal 



Figure 2-25. Establishing the Link With System B 
(Hardwired Example) 
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Finally, the user acquired access to a line between Systems A and 
C and initiated a remote session in System C: 



; DSLINE HDS2 

DS LINE NUMBER = #LU 

; REMOTE HELLO RUSER . RACCOUNT 

HP3000 / MPE IV C.OO.OU. WED, MAR 3» 1982, 1:39 PM 

WELCOME TO SYSTEM C 



HDS2 is the device class name (as defined within System A) 
associated with the particular line. RUSER and RACCOUNT are 
valid user and account names, respectively, as defined by the 
accounting structure of System C. 



We end up with the situation illustrated in figure 2-26, which is 
identical to figure 2-23 that started this exajnple. 
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SYSTEM A 



SYSTEM B 



HDS1 

(DS line number 3) 




REMOTE 
SESSIOM 



SYSTEM C 



REMOTE 
. SESSION 



^ 



/«^S>. 






Figure 2-26. Establishing the Link With System C 
(Hardwired Example) 



2-58 



Opening a Line 



Figure 2-27 illustrates a situation where a user has established 
two telephone conimiini cat ions links concurrently from within a 
single local session* Take a closer look at that situation and 
examine the sequence of commands that was used to create it. 
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SYSTEM A 



y 



SDS1 

(DS line number 3) 



SDS2 

(DS line number 4) 



User's Log-On Terminal 




SYSTEM B 



REMOTE 
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SYSTEM C 



REMOTE 
X SESSION 
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Figure 2-27« Multiple Line Example (Telephone Lines) 
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First the user sat down at a terminal connected to System A and 
initiated a local session: 



; HELLO USER. ACCOUNT 

HP3000 / MPE IV C.OO.OU. WED» MAR 3, 1982, 1:37 PM 

WELCOME TO SYSTEM A. 



USER and ACCOUNT are valid user and account names, respectively, 
as defined by the accounting structure of System A. 



At this point, we have the situation illustrated in figure 2-28. 
Notice that, so far, no communications link exists between any of 
the three systems* 
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SDSI 
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Opening a Line 



SYSTEM B 



[ 



SYSTEM C 



[ 



Figure 2-28. Initiating the Local Session 
(Dial-up Example) 
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Next, the user acquired access to a telephone connection between 
Systems A and B and initiated a remote session in System B: 



t PSLINE SDSl ;LOCID="A" ;REMID="B" ;PHNUM=257-8001 

DS LINE NUMBER = #L3 

: REMOTE HELLO RUSER , RACCOUNT 

HP3000 / MPE IV C.OO.OU. WED, MAR 3» 1982, 1:38 PM 

WELCOME TO SYSTEM B. 



SDSl is the device class name (as defined within System A) 
associated with the particular line, A and B are the ID sequences 
identifying Systems A and B, respectively, and 257-8001 is the 
telephone number of the modem connected to the communications 
interface at System B. RUSER and RACCOUNT are valid user and 
account names, respectively, as defined by the accounting 
structure of System B. 



Now we have the situation illustrated in figure 2-29. 
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Figure 2-29. Establishing the Link With System B 
(Dial-up Example) 
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Finally the user acquired access to a line between Systems A and 

C and initiated a remote session in System C: ^'^^ 



i DSLIME SDS2 ;LOCID="A" ;REMID="C" ;PHNUM=377"2000 

DS LINE NUMBER ^ thk 

: REMOTE HELLO RUSER.RACCOUNT 

HP3000 / MPE IV C.OO.OU. WED, MAR 3, 1982, 1:39 PM 

WELCOME TO SYSTEM C. 



"^ 



SDS2 is the device class name (as defined within System A) 

associated with the particular line, A and C are the ID sequences 

identifying Systems A and C, respectively, and 377-2000 is the 

telephone number of the modem connected to the communications 

interface at System C. RUSER and RACCOUNT are valid user and 

account names, respectively, as defined by the accounting .^si?^ 

structure of System C. ) 

We end up with the situation illustrated in figure 2-30, which is 
identical to figure 2-27 that started this example* 
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Figure 2-30. Establishing the Link With System C 
(Dial-up Example) 
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Line Opening Failures 



There are several reasons why a DSLINE command for opening a 
communications line might be rejected by DSN/DS, some of ^ich 
have already been illustrated earlier in this section. 

The following list summarizes the likely causes of a line opening 
failiire that are common to hardwired lines , leased lines ^ and 
dial-up telephone lines: 

• You made a syntax error in the DSLINE command. 

• Tou gave an erroneous line specification (dsdevice) in the 
DSLINE command. (There is no lODSO or lODSX entry in the 
system configuration with the specified device class name 
or logical device number.) 

• The line was not opened by the local console operator. 

• The line was not opened by the remote console operator. 

• Someone already has exclusive access to the specified line. 

• You asked for EXCLUSIVE access to a line which was already in 
use. 

• DSN/DS detected a hardware problem (the commtmications 
interface board is not responding corre::tly}. 

The following list summarizes the additional causes of a line 
opening failure on a dial-up telephone line: 

m The operator was not able to make the requested telephone ^^^_^^ 

connection and entered NO through the system console in ^^ 

response to the dial request message. 

• The remote computer rejected your local ID sequence. 

• The remote computer did not send a valid ID sequence (the 
received ID sequence did not match any of the remote ID 
sequences that you specified or, if you didn't specify any, 
did not match any of the configured remote ID sequences). 

• The specified line is already in use and the remote ID 
sequence you supplied did not match the one used by the 
currently connected remote HP 3000. 



The various error ntunbers and messages that might appear as a 
result of line opening failures are included in the summary of 
error codes and messages in Appendix B. 
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CLOSING A LINE 



Once you have opened one or more conununications lines , you can 
close any or all of them by using a variation of the DSLINE 
command. The line closing format of the DSLINE command is 
presented in figure 2-31. 



j^^\ 



: DSLINE 



dsdevice 

ds- line -number 



; CLOSE 



Figure 2-31* Closing a Line with the DSLINE Command 



The parameters that pertain to closing one or more communications 
lines are as follows: 



dsdevice 



i^^N 



The device class name, logical device number, or 
logical node name specified in the DSLINE com- 
mand that opened a particular line. 

(Optional parameter. ) 



ds - 1 ine -number 



The DS line number assigned to you by DSN/DS 
when the particular line was opened. Vflien this 
parameter is used, it must appear in the format 
#Ln , where n is the line number (see ''Examples" 
on the following page ) . 

(Optional parameter. ) 



e 



This parameter specifies that you wish to close 
all of the lines that you currently have open. 

(Optional parameter.) 
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; CLOSE This parameter specifies that you wish to close 

the specified line(s). 



(Required parameter.) 



If no line identifier (dsdevice, ds -line-number, or 6) is 
specified 9 DSN/DS closes the line that you most recently opened. 



Examples 

The following examples illustrate the variations of the DSLINE ^ 

command that can be used for closing one or more commimications 
lines . 



: DSLINE HDSl ; CLOSE "^ 

This form closes the line that is identified by the device class 
name HDSl. 



: DSLINE 55 ; CLOSE 

This form closes the line that is identified by the logical 
device number 55* 



: DSLINE € ; CLOSE 
This form closes all the lines that you currently have open. 
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Closing a Line 
:DSLINE #L3 ;CLOSE 
This form closes the line that is identified by #L3. 



:DSLINE ;CLOSE 
This form closes the line that you most recently opened. 



([ If you are sharing one or more physical communications lines with 

other users, the above forms of the DSLINE command close the 
line(s) for your application only (the other user's applications 
are not affected). 
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REMOTE SESSIONS 



SECTION 



III 



A communications link exists after you have initiated a session 
in the remote HP 3000 under the usemame, accountname^ and 
groupname specified in the REMOTE HELLO command. You now have 
two distinct sessions in existence simultaneously from the same 
log-on terminal: a local session (in the HP 3000 to which you 
first logged on) and a remote session (in the HP 3000 at the 
other end of the communications line). Now pause for a moment 
to see what this implies. 

Within the local session, you have access to all I/O devices and 
disc files in your local HP 3000 (subject to the usual MPE file 
seciirity, of cotirse). This is a normal MPE interactive session 
in every respect. You enter MPE commands and use the various 
language and utility subsystems exactly as you would if DSN/DS 
were not present. This local session is running \mder the 
usemame, accountname, and groupname specified in the HELLO 
command that you used to first log on. All user capabilities and 
file access available to you within the local session are 
determined by those log-on parameters. 

Within the remote session, you have access to all I/O devices and 
disc files in the remote HP 3000 (again, subject to the usual MPE 
file security). With the few minor exceptions described in the 
following pages, this is also a normal MPE interactive session. 
All MPE commands and subsystems are, however, executed in the 
remote HP 3000. The output resulting from the executed commands 
and subsystems appears at your local log-on terminal. The remote 
session is running under the usemame, accountname, and groupname 
specified in the REMOTE HELLO command that you used in 
establishing the communications link. All user capabilities and 
file access available to you within the remote session are 
determined by those log-on parameters. 

For the sake of clarity and as a learning aid, the remainder of 
this section will treat local and remote sessions as separate 
(and essentially unrelated) entities that use only those 
resources available in the particular HP 3000 in which they are 
running. Actually, it is possible to access the I/O devices and 
disc files of the remote HP 3000 computer from your local 
session, and it is also possible to access the I/O devices and 
disc files of the local HP 3000 from your remote session. This 
more advanced activity will be covered in Section IV, "Remote 
File Access". 
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ISSUING REMOTE COMMANDS 



Remember that^ in the previous sections, the following sequence 
of commands was used to establish the communications link: 

carriage return 

: HELLO USER. ACCOUNT \ 

HP3000 / MPE IV C.OO.OU. WED, MAR 3, 1982, 9:05 AM } a^nd^o^^^Ss^iry 

I for local session. 

WELCOME TO SYSTEM A. / 

i DSLINE HDS2 

DS LINE NUMBER = #L3 

: REMOTE HELLO RUSER > RACCOUNT 

HP3000 / MPE IV C.OO.OU, WED, MAR 3, 1982, 9:06 AM I hello command 
' » ** 1 • » • V and log-on display 

for remote session. 
VELCQME TO SYSTEM B. 



At this point, the remote session has been initiated, but you are 
currently in the local session (as signified by the colon prompt 
character). To execute a command in the remote session, use the 
following construct: 

: REMOTE [xxx] command 

where xxx is the DS line number returned by DSN/DS when the 

communications line was opened, and command is the desired MPE "''^ 

command in its normal format* (The DS line number is necessary / 

only if you have more than one communications line open 

simultaneously; if it is omitted, then the line which you most 

recently opened is referenced by default). In the example in 

Section I, this construct was used to execute a LISTF command, as 

follows : 



: REMOTE LISTF 

FILENAME 

DATAl DATA5 DATA6 FILE3 SOURCEl 



Because the prefix REMOTE was included, the LISTF command is 
executed in the remote session (the implied account and group 
names are those established by the REMOTE HELLO command that 
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Remote Sessions 



initiated the remote session)* Although the LISTF command is 
executed in the remote HP 3000, the output generated by the 
command is displayed at your local log-on terminal. 

Notice, in the above example, that the DS line number associated 
with the pairticular communications line was not specified (3 in 
this example). This is because, if no line number is specified, 
DSN/DS uses (by default) the line most recently opened. Only one 
communications line is open from your local session; so DSN/DS 
uses that line by default. If you had opened a second line, you 
would need to tell DSN/DS in ^ich remote computer the remote 
command is to be executed. To tell DSN/DS, include the appropri- 
ate DS line number in the remote command, as follows: 



; REMOTE 3 LISTF 

FILENAME 

DATAl DATA5 DATA6 FILE3 SOURCEl 



The above construct only allows you to execute a single remote 
command. After the remote command has been executed, control 
returns to your local session (as signified by the colon prompt 
character) . 

But suppose that you want to execute a whole series of remote 
commands. It would obviously be a nuisance to have to prefix 
each command with the word REMOTE. DSN/DS provides a convenient 
solution to this situation. To execute a series of commands in 
the remote session, use the following construct: 



: REMOTE [xxxj 



where xxx is again the DS line number of the desired communica- 
tions line (specifying in which remote HP 3000 we want to execute 
commands). DSN/DS then prompts you for each command by display- 
ing a # in column 1 of your terminal (in place of the standard 
MPE colon prompt). In the example in Section I, this construct 
was used for entering two remote MPE commands, EDITOR and BYE. 
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After reviewing the example in Section I, try another example 
that uses more than those two remote commands: 



i BEtiCfTE 
f LISTF 

FILENAME 

DATAl DATA3 DATA6 FILE3 SOURCEl 
I PURGE DATA5 
# PURGE DATAb 
f LISTF 

FILENAME 

DATAl FILE3 SOURCEl 

# RUN FCOPY.PUB.SYS .^ssk 

1 
HP32212A.0.03 FILE COPIER 

> FR0M=DATA1 ;T0=DATA2 ;NEW 

EOF FOUND IN FROMFILE AFTER RECORD 679 

680 RECORDS PROCESSED *** ERRORS 

>EXIT 



END OF PROGRAM 
f LISTF 

FILENAME 

DATAl DATA2 FILE3 SOURCEl 
fBYE 



CPU=lt. C0NNECT=7. WED, MAR 3, 1982, 9:13 AM 
f: 



Notice that except for the f prompt (in place of the standard 

colon prompt) this looks exactly like a normal MPE interactive 

session. All of the commands shown in the previous example are 

entered through the local log-on terminal, but the MPE and FCOPY 

commands are executed in the remote session within the remote HP 

3000. After each remote MPE command was executed, however, 

control remained in the remote session (as signified by the f 

prompt character) . When the remote session was terminated and 

the user typed a colon (:) in response to the f prompt following 

the log-off message, control was then returned to the local '"^ 

session (as signified by the colon prompt). 
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Using The Remote Subsystem From a Batch Job 

While in a batch job, jrou can establish a remote session by using 
the DSLINE or REMOTE HELLO command. 

The job to be streamed may be similar to the following: 

:JOB USER. ACCOUNT 

: DSLINE HDS2 

: REMOTE HELLO RUSER . RACCOUNT 

: REMOTE 

#FILE OUT;DEV=LP 

#BUILD WORK;DISC=50 

#RUN USERPROG 

fPURGE WORK 

#: 

: REMOTE BYE 

: DSLINE; CLOSE 

:EOJ 



NOTE 



j^P^'V 



The remote # prompt is optional. 



An important point to remember is that, once established, the 
remote session is interacting with the job in the same way as it 
would interact with a terminal. If the remote session detects an 
error, the error is printed to $STDLIST and the next record in 
the job file is read (in the same manner as waiting for a 
character or carriage return on a terminal) . The record is then 
lost to the job. 



The BREAK Key 

Within a remote session, you can use the BREAK key to temporarily 
interrupt remote processing. When doing so, either you may 
return control to the MPE Command Interpreter of your local HP 
3000, or you may temporarily suspend the remote subsystem that 
you are executing without returning control to the local HP 3000. 
This is detexmined by how you execute commands in the remote 
session. There are two ways to execute commands in a remote 
session: 

• By prefixing each command with the word REMOTE. 

• By entering the word REMOTE, which prompts you for each 
command. 
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Prefixing Each Command With REIMOTE when you are conducting a 

remote session by prefixing each command with the word REMOTE, 
pressing the BREAK key returns control to the local Command 
Interpreter and you receive the colon (:) prompt. To continue 
remote processing at the point ^ere it was interrupted, you 
merely enter REMOTE RESUME in response to the local MPE colon 
prompt • 

As an example, assume that you are in the midst of using the text 
editor in a remote session when you suddenly decide to start a 
job stream executing concurrently in your local HP 3000. The 
sequence of commands would be similar to the following: 



: REMOTE EDITOR 



Local 

session 

prompt. 



HP32201A.7.05 EDIT/3000 FRI, MAY 9» 1980, 9:11 AM 

(C) HEWLETT-PACKARD CO. 1979 

/ ADD 

1 

2 

3 

U 

5 



,.-*^ 



DOE. JOHN 


2? 


M 


CHI 


BLACK « PATRICIA 


23 


F 


SF 


SIMON, NEIL 


J»3 


M 


NY 


MACK, SHIRLEY 


36 


F 


DET 



*7. 



BREAK key pressed here. 



^ 



: STREAM COBIESTI 

#J19 
:REMOTE RESUME 



Control is now 
in the local 
session. 



READ PENDING 

MICHAELS, WILLIAM 32 N CHI 




6 O'LEARY, TIMOTHY k9 M 


DET 


7 MARTIN, MARY 3k F 


LA 


8 MURIN, JOICE 42 F 


CHI 



Control is 
now back in 
the remote 
session. 



Notice that when the BREAK key was pressed, the text editor in 
the remote HP 3000 was waiting for you to enter the text for line 
?• The BREAK key interrupted the remote session and passed 
control to the MPE Command Interpreter of the local HP 3000 (as 
signified by the colon prompt). The STREAM command was issued 
within the local session, which caused the file COBTESTl to be 
executed in the local HP 3000. Then, when the RESUME command was 
issued, control was passed back to the remote session at the 
point where it was interrupted (that is, the text editor in the 
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remote HP 3000 is now waiting for you to enter the text for line 
5). When the text for line 5 is entered, the remote session 
proceeds as though nothing had happened. 

Note that by the end of the example, the local job stream, the 
local session, and the remote session are all operational 
s imultaneous ly . 



Entering REMOTE When you are interacting with the remote 
Command Interpreter by having entered the word REMOTE and you are 
receiving the remote prompt (#), pressing the BREAK key will 
temporarily suspend the subsystem you are executing and will 
return control to the remote Command Interpreter, To continue 
remote processing at the point where it was interrupted, you 
merely enter RESUME in response to the remote prompt. 

As an example, assume that you are in the midst of using the text 
editor in a remote session when you suddenly decide to start a 
job stream executing in your remote HP 3000. The sequence of 
commands would be similar to the example shown previously, but 
with a few minor differences, as follows: 



y^^N 



; REMOTE 
f EDITOR 

HP 322OIA.7.O5 EDIT/3000 FRI, FEB 13, I98I, 9^20 AM 

(C) HEWLETT-PACKARD CO. 1979 

/ ADD 

1 LEWIS, LEO 5L M SV 

2 

3 
U 

5 



BREAK key pressed here. 



LAGERGREN, FRED 


25 


M 


SJ 


DICKINSON, MARY 


21 


F 


SC 


LAGREGREN, LINDA 


2k 


F 


SJ 



# STREAM APLTESTl 

#J20 
f RESUME 

READ PENDING 
MELLO, HENRY 

— S 



SPARES, JOE 



Control is still 
in the remote 
session. 



UU M SJ 



7 
8 



LAWRENCE, ALICE 



LEWIS, BOB 



39 M LA 
kk F SJ 



29 M WASH 



i^!te\ 
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Notice that when the BREAK key was pressed, the text editor in 

the remote HP 3000 was waiting for you to enter the text for line /^^ 

3* The BREAK key interrupted the remote session, but control / 

remained in the remote HP 3000 (as signified by the remote # 

prompt)* The STREAM command executed the file APLTESTl within 

the remote HP 3000. Then, idien the RESUME command was issued, 

control was passed back to the point idiere the text editor was 

interrupted (that is, the text editor is waiting for you to enter 

the text for line 5)* When the text for line ^ is entered, the 

remote session proceeds as though nothing had happened. 



The Control Keys 

Within a remote session Control-H, Control-X, and Control- Y 
perform exactly the same functions as they do in a normal MPE 
interactive session* 

For example, if you are using FCOPY or the text editor in a 
remote session, you can use Control-Y to prematurely terminate an 
FCOPY or text editor operation. When the operation terminates, 
control is still in the particular subsystem within the remote 
session* 

Similarly^ you can use Control-H to delete the last character 

entered or Control-X to delete the line of text currently being 

entered* In both of these cases, after the deletion occurs, "^^^ 

control remains in the remote session* 



rSSUING LOCAL COMMANDS 

Whenever the standard MPE colon prompt is displayed at your ^^ 

terminal, you are in the local session* Within the local ''^\ 

session, you enter MPE commands in their normal format in 

response to the colon prompt* If you are in the midst of a 

remote session (that is, you used the command : REMOTE, and DSN/DS 

is issuing the # prompt character) , you can return control to 

your local session by entering a colon, as follows: 



In response to the remote colon, control returns to the MPE 
Command Interpreter of your local HP 3000 which then prompts you 
for local commands with the colon prompt character. Note that 
the remote colon does not terminate the remote session; you can 
resume processing in the remote session by again using either of 
the constructs described under "Issuing Remote Commands'*. 
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TERMINATING A REMOTE SESSION 



You can terminate a remote session either from within the local 
session or from within the remote session itself. 



From The Local Session 

Whenever the standard MPE colon prompt is displayed at your 
terminal, you are in the local session. To terminate a remote 
session from within your local session, use the following 
command: 



: REMOTE [xxx] BYE 



idiere xxx is the DS line number associated with the 
communications line connecting the particular remote session to 
your local session. (The DS line niomber is necessary only if you 
have more than one communications line open simultaneously; if 
it is omitted then the line that you most recently opened is 
referenced by default.) 

For instance, in the example in Section I, either of 

the following sequences could have been used to terminate the 

remote session: 



#1 

: REMOTE BYE 

CPU=i*. C0NNECT=7. WED, MAR 3, 1982, 9:13 AM 



: REMOTE 3 BYE 



CPU=U. C0NNECT=7. WED, MAR 3, 1982, 9:13 AM 



In "both cases, the remote colon was used to retuim control from 
the remote session to the local session. In either case, the 
remote session is terminated. 
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If the commxmications line was opened using the DSLINE== parameter 
of the REMOTE HELLO command, the line is automatically closed 
when the remote session terminates* To initiate another remote 
session over the same communications line, you must once again 
open the line (using either the DSLINE command or the DSLINE= 
parameter of the REMOTE HELLO command) and then issue another 
REMOTE HELLO command. 

If the communications line was opened using the DSLINE command, 
it is still open. To initiate another remote session over the 
same communications line, merely issue another REMOTE HELLO 
command (you do not need to issue another DSLINE command because 
the communications line is still open). To close the communica- 
tions line, use the constructs presented in Section II. 



From The Remote Session 

Whenever the # prompt is displayed at your terminal, you are in 
the remote session. To terminate a remote session from within 
the remote session itself, use the following commaind: 



#BTE 



Note that you do not need to supply a DS line number in this 
case, because DSN/DS knows implicitly T^ich remote session you 
wish to terminate (that is, the one in which the #BYE command is 
executed) . 

Remember that this command was used to terminate the remote 
session in the example at the end of Section I, as follows: 

#BYE 

CPU=U. C0NNECT=7. WED, MAR 3, 1982, 9:15 AM 
# 



Notice that although the remote session is terminated, DSN/DS is 
still issuing the # prompt character. To return control to the 
local session, issue a colon (described earlier under ''Issuing 
Local Commands'*). 

If the communications line was opened using the DSLINE command, 
it is still open. To initiate another remote session over the 
same commxmications line, merely issue an appropriate remote MPE 
HELLO command. (You do not need to use the prefix REMOTE because 



-^ 



.^'''^ 



z***^ 



./f^s^ 
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DSN/DS is still waiting for you to enter a remote command; nor do 
you need to issue another DSLINE command because the communica- 
tions line is still open.) To close the communications line, use 
the constructs presented in Section II. 

If the communications line was opened using the DSLINE'^ parameter 
of the REMOTE HELLO command, the line is automatically closed 
idien the remote session terminates. To initiate another remote 
session over the same line, you must once again open the line 
(using the DSLINE command or the DSLINE= parameter of a REMOTE 
HELLO command) and then issue another REMOTE HELLO command. 



j^^^\ 
^ 



^^\ 



j^\. 
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IV 
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In the preceding sections » you have seen how you can establish a 
commxinications link between two HP 3000s and thereby use the 
computing power of the remote HP 3000. But that is only part of 
the story! Through the use of the DSN/DS Remote File Access 
(RFA) capability, programs running in your local session can: 

• Use any of the devices connected to the remote HP 3000 as 
though they were connected directly to your local HP 3000 

• Access any of the disc files of the remote HP 3000 (subject to 
the normal MPE file security, of course) as though they 
resided at your local HP 3000 site. 



^ 



The RFA capability, in conjunction with the remote session 
capability, suddenly puts all of the computing power and all of 
the hardware and software resources of a remote HP 3000 at your 
fingertips. 

Section IV is divided into two main parts. The first part, 
"Command Access", describes how you can issue local MPE FILE 
commands that define devices and/or files residing at the remote 
HP 3000 site. The second part, "Programmatic Access", describes 
how you can use the standard set of MPE File System intrinsics 
within your local programs to access devices amd/or files 
residing at the remote HP 3000 site. 



Ii0^\ 
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COMMAND ACCESS 

After a DSN/DS communications link has been established , you can 
issue local MPE FILE commands that define devices and/or files 
residing at the remote HP 3000 site. To make this possible, the 
DEV= parameter of the MPE FILE command has been expanded to 
include a DS line specification in addition to the usual device 
specification. To specify a file that resides across a DS line, 
the format of the DEV= parameter is as follows: 

;DEV= [dsdevice]# [device] 

where dsdevice is the device class name, logical device number, 

or node name that you used when establishing the particular 

communications link (this specifies the physical line connecting 

the two computers); and device is the device class name or """^^ 

logical device number of the desired remote device as established ^ 

within the remote HP 3000, 



NOTE 



When the FILE command is entered on a remote 
system to point back across to a file on the 
local system, dsdevice is omitted. 



Figure U-1 is an excerpt from the MPE Commands Reference Manual, 
showing only the parts of the syntaoc and parameter specifications 
pertinent to and including the dsdevice# parameter. (Refer to 
the MPE Commands Reference Manual for the complete syntaix and all 
parameters.) The dsdevice# parameter (within the DEV= parameter) 
is the only parameter unique to DSN/DS. This one small item of 
sjmtax is enormously powerful. It means that from within your 
local session you can access any of the devices and/or disc files 
of a remote HP 3000 as though they resided at your local HP 3000 
site. Access to remote disc files is, of course, subject to the 
usual MPE file security. The user, account, and group names that 
you specified in the REMOTE HELLO command when establishing the 
communications link are the ones used by MPE in the remote HP 
3000 for determining your file access capabilities. 

Following figure k-l are five annotated examples illustrating 
remote device and file access from a local session. 
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SYNTAX 

: FILE namespec [filechar][disposition][filechar] 



PARAMETERS 



yP^N 



namespec 



filechar 



disposition 



Consists of the formal name used by the program and may 
be equated to another file in the system. (REQUIRED 
PARAMETER) 

A list of parameter specifying devicespec (the physical 
description of the REC, DEV, ENV, DEN, DISC, CODE, 
RIO, NORIO, STD, MSG, and CIR options) and access 
(the type of access granted to a file). 

Specifies what is to be done with the file after it is closed. 
This consists of the DEL,SAVE, and TEMP options. 



SYNTAX FOR NAMESPEC 



^^^. 



formaldesignator 



= * formaldesignator 
=$NULL 
=$NEWPASS 
=$OLDPASS 
=$STDIN 
=$STDINX 
=$STDLIST 
_^fllereference\ 



r,NEW 
,OLD 
L.OLDTEMPj 



^^> 



SYNTAX FOR FILECHAR 

[devicespec {access]\ [fUgchar] 
laccess [devicespec] J 



Figure U-1. MPE FILE Command (Pertinent Excerpts) 



U-3 



:FILE 



SYNTAX FOR DEVICESPEC 

[;REC= [recsize][,lblockfactor] [,[F] [.BINARY]]]] 

[U] [.ASCII ] 
[V] 



DEV = [[dsdevice] # ] [device] [,[outpriority] [^umcopies] ] ] 

ENV = [environment] ] 

DEN = [density] ] 

DISC = [numrec] [,numextents] [,initalloc] ] ] 

CODE = [filecode] ] 

RIO 

NORIO 

STD 

MSG 

CIR 



SYNTAX FOR ACCESS 

[•nocctl] 
;CCTL J 



[;ACC = 



I 



;NOMULTI 

;MULTI 

;GMULTI 



IN 

OUT 

UPDATE 

OUTKEEP 

APPEND 

INOUT 



] 



t-NOMR 
;MR 

HWAIT "] 
IjNOWAIT J 



HbUF [ = [numbuffers]] 
L;NOBUF 



'] 



EXC 
SHR 
EAR 
SEMI 



pNOLABEL 

[jLABEL [ = [volid] [ , [type] [ , [expdate][, seg]]]] 

SYNTAX FOR DISPOSITION 

[;DEL ] 

[;TEMP] 

[;SAVE] 



[•NOLOCK ~| 
;LOCK J 

[;NOCOPY ~| 
jCOPY J 



r 



FORMS= formsmsg] 



/^^ 



Figure U-l. MPE FILE Command (Pertinent Excerpts) (continued) 
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Command Access 

Example #1 

Assmne that you are maintaining an ASCII file containing both 
uppercase and lowercase characters using the Text Editor on your 
HP 3000 but that you don't have an upper/ lowercase line printer. 
Assume further that elsewhere in the same building there is 
another HP 3000 with an upper/lowercase line printer, that both 
HP 3000s have DS capability, and that they are connected to one 
another by an interconnecting cable and communications inter- 
faces. You can access the remote line printer as follows. 

First, the console operators of both computer systems OPEN the 
line. Then, you log on to your HP 3000 and establish a communi- 
cations link with the remote HP 3000. 

: HELLO USER. ACCOUNT 

: REMOTE HELLO RUSER.RACC0UNT;DSLINE=LINE2 



lAere USER and ACCOUNT are valid user and account names (respec- 
tively) within the accounting structure of your local HP 3000, 
RUSER and RACCOUNT are valid user and account names (respective- 
ly) within the accounting structure of the remote HP 3000, and 
LINE2 is the device class name of the lODSO entry (or the node 
name of the lODSX entry) for the local communications interface 
to which the interconnecting cable is connected. 

Next, issue a local MPE FILE command that defines the desired 
line printer as a remote device. 



; FILE LIST;DEV=LINE2#SL0WLP 



where LIST is the formaldesignator by which you will subsequently 
reference the line printer, LINE2 is the device class name you 
used when establishing the particular communications link, the # 
symbol tells the local file system that the next parameter 
references a device on the remote system, and SLOWLP is the 
device class name (as established within the remote HP 3000) of 
the upper/ lowercase line printer. 
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Then^ invoke the Text Editor of your local HP 3000, specifying 
the remote line printer as the off-line listing device: 



:EDITOR *LIST 



Thereafter, direct the Text Editor offline output to the remote 
upper/lowercase line printer as though it were connected directlj 
to your local HP 3000. For example, you could print the content 
of the file TEXTFILE on the upper/lowercase line printer as 
follows : 



/ TEXT TEXTFILE 
/ LIST ALL, OFFLINE 

The entire command sequence is as follows (refer to Figure U-2): ] 

; HELLO USER. ACCOUNT 

HP3000 / MPE IV C.OO.OU. TUE, AUG 3, 1982, 12:31 FN 

WELCOME TO SYSTEM A. 

♦ REMOTE HELLO RUSER.RACC0UNT;DSLINE=LINE2 

DS LIME NUMBER = #L3 

HP3000 / MPE IV COCQl*. TUE, AUG 3, 1982, 12:52 PM 

WELCOME TO SYSTEM B. 

: FILE LIST;DEV=LINE2#SL0WLP 
; EDITOR *LIST 

HP32201A.7.10 EDIT/3000 TUE, AUG 3» 1982, 12:53 PM 

(C) HEWLETT-PACKARD CO. I98I 

/ TEXT TEXTFILE 

/ LIST ALL. OFFLINE 

*** OFF LINE LISTING BEGUN. *** 



'<«% 
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DISC 



TEXTFILE 



SYSTEM A 



SYSTEM B 



EDITOR 




Line 2 




■{ 




Upper/ Lower Case 
Line Printer (SLOWLP) 



Figure U-2. Remote Off -Line Listing Example 
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Example #2 

Assume that there is a file named SOURCE residing on a disc con- 
nected to a remote HP 3000 and that SOURCE contains a list of 
clients sorted alphabetically by the clients* names. Assume 
further that the remote HP 3000 and your local HP 3000 both have 
DSN/DS configured and that they are interconnected by a hardwired 
connection* 7ou wish to access the remote file SOURCE from your 
local HP 3000 » sort its content alphabetically by the names of 
the states in which the clients reside, and store the sorted 
version in a newly created disc file named SORTED on your local 
HP 3000. You can do that (without disturbing the original con- 
tent of SOURCE) as follows. 

First, the console operators of both systems open the line to 
make it available. Then, log on to your local HP 3000 and estab- 
lish a communications link with the remote HP 3000. 



; HELLO USER. ACCOUNT 

tREMOTE HELLO RUSER.RACC0UNT;DSLINE=LINE2 



where USER and ACCOUNT are valid user and account names (respec- 
tively) within the accounting structure of your local HP 3000, 
RUSER and RACCOUNT are valid user and account names (respective- 
ly) within the accounting structure of the remote HP 3000, and 
LINE2 is the device class name of the local DSN/DS Communications 
Driver (lODSO or lODSX) that is associated with the line you want 
to use. 

Next, issue a local MPE BUILD command to create the local disc 
file SORTED that will receive the sorted output. 



; BUILD SORTED;DISC=250,l,l;REC=-80,l6,F,ASCII 



Then, issue .two local MPE FILE commands: one that defines the 
remote disc file SOURCE as the sort input file and one that 
defines the local disc file SORTED as the sort output file. 



; FILE INPUT=S0URCE;DEV=LINE2#DISC 
:FILE OUTPUT=SORTED 
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Then, invoke the Sort program, specify the sort key, and 
initiate the actual sort. 



:RUN SORT. PUB. SYS 



> KEY 50 » 9 
>END 



Note that the sort is performed in your local HP 3000, using the 
remote disc file SOURCE as the sort input file; the output of the 
sort is stored in the local disc file SORTED; and the original 
content of SOURCE is not altered. 

The entire command sequence is as follows (refer to figure U-3): 



! HELLO USER. ACCOUNT 

HP3000 / MPE IV C.OO.OU. TUE, AUG 3, 1982, 12:51 PM 

WELCOME TO SYSTEM A. 

; REMOTE HELLO RUSER.RACC0UNT;DSLINE=LINE2 

DS LINE NUMBER = #L3 

HP3000 / MPE IV C.OO.OU. TUE, AUG 3, 1982, 12:52 PM 

WELCOME TO SYSTEM B. 

BUILD SORTED;DISC=250,l,l;REC=-80,l6.F, ASCII 



FILE INPUT=S0URCE;DEV=LINE2#DISC 



FILE OUTPUT=SOKrED 



RUN SORT. PUB. SYS 



^^t^ HP322lUC.02.06 SORT/3000 TUE, AUG 3» 1982, 12:53 PM 

f (C) HEWLETT-PACKARD CO. I98O 



> KEY 50,9 
>END 



STATISTICS 



NUMBER OF RECORDS = 221 

RECORD SIZE (IN BYTES) = 8O 

NUMBER OF INTERMEDIATE PASSES = 

SPACE AVAILABLE (IN WORDS) = 13,3^6 

NUMBER OF COMPARES = U5 
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NUMBER OF SCRATCHFILE 10 'S 
CPU TIME (MINUTES) = 
ELAPSED TIME (MINUTES) = 



10 
.01 
.lU 



END OF PROGRAM 



DISC 



SORTED 



SYSTEM A 



SYSTEM B 



Line 2 



Log-On Terminal 




SOURCE 



Figure U-3* SORT Remote File Access Example 
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Example #3 

Suppose that you want to copy a disc file from your local HP 3000 
to a remote HP 3000* Assume a hardwired connection and DSN/DS is 
configured. You can perform the file copy operation as follows. 

First, both ends of the line must be opened by the console 
operators. Then, you log on to your local HP 3000 and establish 
a communications link with the remote HP 3000. 



; HELLO USER. ACCOUNT 

i REMOTE HELLO RUSER.RACC0UNT;DSLINE=LINE2 



where USER and ACCOUNT are valid user and account names (respec- 
tively) within the accounting structure of your local HP 3000, 
RUSER and RACCOUNT are valid user and account names (respective- 
ly) within the accounting structure of the remote HP 3000, and 
LINE2 is the node name or the device class name of the local 
lODSO that is associated with the line that you want to use. 

Next, issue a local MPE FILE command defining the destination 
file (REMFILE) as being a remote disc file. 



:FILE REMFILE;DEV=LINE2#DISC 



Then, invoke the File Copier and specify the file copy 
parameters . 



:RUN FCOPY.PUB.SYS 



> FROM=LOCFILE ;TO=:»REMFILE ;NEW 



A new disc file named REMFILE is created in the home group of the 
RACCOUNT account in the remote HP 3000 and the content of the 
local disc file LOCFILE is then copied over the communications 
line into REMFILE. 
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The entire command sequence is as follows (refer to figure U-U): 

; HELLO USER.ACCOllHT 

HP3000 / MPE IV C.OO.OU. WED, MAR 3» 1982, 12:51 PM 

WELCOME TO SYSTEM A. 

; REMOTE HELLO RUSER.RACC0UNT;DSLINE=LIME2 

DS LINE NUMBER = #L3 

HP3000 / MPE IV C.OO.OU. WED, MAR 3, 1982, 12:52 PM 

WELCOME TO SYSTEM B. 

; FILE REMFILE;DEV=LINE2»DISC 
: RUN FCOPY.PUB.SYS 

HP32212A.3.1U FILE COPIER (C) HEWLETT-PACKARD CO. I98I 

> FROM=LOCFILE ;TO=*REMFILE ;NEW 

EOF FOUND IN FROMFILE AFTER RECORD 2017 

2018 RECORDS PROCESSED •** ERRORS 

> EXIT 

END OF PROGRAM 



'"^ 
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J^S. 



SYSTEM A 



SYSTEM B 



DISC 




FCOPY 



LOCFILE 




Line 2 



...^ 



c 




^ DISC 



Lo9-0n Terminal 




REMFILE 



Figure U-U. FCOPY Remote File Access Example 
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Example #4 

Assxime that there is a COBOL source file named SOURCEl residing 
on a disc connected to a remote HP 3000 and that you want to 
compile, prepare, and execute that program on your local HP 3000 « 
Assume further that the remote HP 3000 and your local HP 3000 
both have DSN/DS configured and a hardwired interconnection* Tou 
can locally compile, prepare, and execute the remote source file 
as follows. 

First, the console operators must open both ends of the DS line. 
Then, log on to your HP 3000 and establish a communications link 
with the remote HP 3000. 

; HELLO USER. ACCOUNT 

; REMOTE HELLO RUSER.RACC0UNT;DSLINE=LINE2 ,^ 

where USER and ACCOUNT are valid user and account names 
(respectively) within the accounting structure of your local 
HP 3000, RUSER and RACCOUNT are valid user and account names 
(respectively) within the accounting structure of the remote 
HP 3000, and LINE2 is the device class name of the local lODSO 
entry associated with the line that you want to use. 

Next, issue a local HPE FILE command defining the file SOURCEl as 
being a remote disc file. 



; FILE SOURCEl ;DEV=LINE2#DISC 



where LINE2 is the node name or the device class name that you 
used when establishing the communications link and DISC is the 
device class name (as established within the remote HP 3000) of 
the disc on which SOURCEl resides. 

Then, invoke the COBOL compiler and the Segmenter of your local 
HP 3000, specifying the remote disc file SOURCEl as the 
inputfile. 



iCOBOLGO *S0URCE1 
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The content of the remote disc file SOURCEl is compiled, prepared 
and executed in your local HP 3000. 

The entire command sequence is as follows (refer to figure U-S): 



; HELLO USER. ACCOUNT 

HP3000 / MPE IV C.OO.OU, WED, MAR 3, I982, 12:51 PM 

t REMOTE HELLO RUSER.RACC0UNT;DSLINE=LIME2 

DS LINE NUMBER ^ #L3 

HP3000 / MPE IV C.OO.OU. WED, MAR 3, 1982, 12:52 PM 

: FILE SOURCEl ;DEV=LINE2#DISC 
: COBOLGO ^SOURCEl 

PAGE 0001 HP322i3O.Ol.OO (C) HEWLETT-PACKARD CO. 1976 

(SOURCEl is now being compiled.) 

DATA AREA IS %0003Ul WORDS. 
CPU TIME = 0:00:01. WALL TIME == 0:00:07. 
END COBOL/3000 COMPILATION. NO ERRORS. NO WARNINGS. 

END OF COMPILE 

(The compiled version of SOURCEl is now being 
prepared by the MPE Segmenter . ) 

END OF PREPARE 

(The compiled and prepared version of SOURCEl is 
now being executed.) 

END OF PROGRAM 
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NOTE 



Due to the amount of time and system resources required 
for COBOL activity, this example (and also Example #3) 
does not make efficient use of a DS line* The general 
rule is to do the COBOL compile, preparation, and run 
on the same system ^ere the data resides. Sometimes 
this means copying the data files to another system 
before (or after) COBOL activity, rather than copying 
across the line during the COBOL activity. 



SYSTEM A 




COBOL 

Segmenter 

' User Program 



I Line 2 I 



SYSTEM B 




Log-On Terminal 




DISC 



SOURCE 1 



,./*^ 



Figure U-^. COBOLGO Remote File Access Example 
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Example #5 

Assxirae that there is a COBOL source program named SOURCEl resid- 
ing on a disc connected to a remote HP 3000 and that you want to 
incorporate changes into the content of that file from a local 
file named CHANGES, compile the updated source code on your local 
HP 3000, and store a copy of the updated source code in a new 
file named SOURCEIA on the disc connected to the remote HP 3000 
Assume further that the remote HP 3000 and your local HP 3000 
both have DS capability and a hardwired interconnection. You 
can perform the update and compilation as follows: 

First, log on to your HP 3000 and establish a communications link 
with the remote HP 3000. 



: HELLO USER. ACCOUNT 

; REMOTE HELLO RUSER.RACC0UNT;DSLINE=LINE2 



where USER and ACCOUNT are valid user and account names 
(respectively) within the accounting structure of your local 
HP 3000, RUSER and RACCOUNT are valid user and accoxmt names 
(respectively) within the accounting structure of the remote 
HP 3000, and LINE2 is the device class name of the local lODSO 
entry associated with the line that you want to use. 

Next, issue two local MPE FILE commands: one that defines the 
source file SOURCEl as being a remote disc file and one that 
defines the file SOURCEIA as a new remote disc file. 



: FILE SOURCEl ;DEV=LINE2#DISC 

: FILE S0URCE1A,NEW;SAVE;DEV=LINE2#DISC 



where LINE2 is the node name or the device class name you used 
when establishing the particular communications link, DISC is the 
device class name (as established within the remote HP 3000) of 
the disc on which SOURCEl resides and SOURCEIA will reside, and 
NEW;SAVE specifies that SOURCEIA is to be a new permanent file. 



Mr^^' 
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Then, invoke the local COBOL compiler, specifying the local disc ^^ 

file CHANGES as the update input file (textfile), the remote disc "^ 

file SOURCEl as the source input file (masterf ile) , and the .^J 
remote disc file SOURCEIA as the updated source file (newfile). 

; COBOL CHANGES . . , *S01]RCE1 . *S0URCE1A 

The source code in the remote disc file SOURCEl is updated by the 
content of the local disc file CHANGES, a new permanent disc file 
named SOURCEIA is created in the remote HP 3000, and the 
resultant source code is stored in the remote disc file SOURCEIA. 
Note that the updating operation is performed by the COBOL 
compiler in your local HP 3000. 

The entire command sequence is as follows (refer to figure U-6): 

; HELLO USER. ACCOUNT 

HP3000 / MPE IV C.OO.OI+. WED, MAR 3, 1982, 12:51 PM 

: REMOTE HELLO RUSER.RACC0UNT;DSLINE°LINE2 

DS LINE NUMBER = #L3 

HP3000 / MPE IV C.OO.OU. WED, MAR 3, 1982, 12:52 PM 

; FILE SOURCEl ;DEV=LINE2#DISC 

; FILE S0URCE1A,NEW;SAVE;DEV=LINE2»DISC 

: COBOL CHANGES . , . *S0URCE1 , *S0URCE1A 

PACE 0001 HP322i3O.Ol.OO (C) HEWLETT-PACKARD CO. 1976 

(SOURCEl is now being updated and compiled. ) 

DATA AREA IS %0003Ul WORDS. 
CPU TIME = 0:00:01. WALL TIME = 0:00:17. 
END COBOL/3000 COMPILATION. NO ERRORS. NO WARNINGS. 

END OF C(»4PILE 
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SOURCE 1A SOURCE 1 



Figure k-S. COBOL Remote File Access Example 
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NOTE 



Many aspects of system resources (for example » memory 
size, CPU load, type of CPU load, time quantums, etc.) 
affect how COBOL activities (and also remote data base 
access activities) are conducted in a DSM/DS environ- 
ment. In general, it is more efficient to trauasfer 
data, USL, and SL files before or after (but not during) 
COBOL activity. 
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PROGRAMMATIC ACCESS 

Once a DSN/DS communications link has been established between 
your HP 3000 and a remote HP 3000, you can use the standard set 
of MPE File System intrinsics within your local programs to 
access devices and/or files residing at the remote HP 3000 site. 
To make this possible, the format of the byte array referenced by 
the device parameter of the MPE FOPEN intrinsic has been expanded 
to include a DS line specification in addition to the usual 
device specification. The format of the device byte array is as 
follows : 

dsdevicef [device] 

where dsdevice is the device class name, logical device ntimber, ""^ 

or node name that you used Tdien establishing the particular 

communications link (this specifies the physical line connecting 

the two computers) and device is the device class name or logical 

device number of the desired remote device as established within 

the remote HP 3000. 

The full syntax for the MPE FOPEN intrinsic is presented in 

figure U-7. However, for conciseness, only the "device" ^^^ 

parameter specifications are shown in figure U-8. (For a "^ 

complete presentation of all FOPEN intrinsic parameters, refer to 

the MPE Intrinsics Reference Manual.) The addition of 

"dsdevice#" to the format of the byte array referenced by the 

device parameter has enormously powerful implications. It means 

that programs executing in your local HP 3000 can easily access 

any of the devices and/or disc files of a remote HP 3000 as 

though they resided at your local HP 3000 site. Access to remote 

files is, of course, subject to the usual MPE file security. The ^^^_^ 

user, account, and group names that you specified in the REMOTE ^^ 

HELLO command when establishing the communications link are the 

ones used by MPE in the remote HP 3000 for determining your file 

access capabilities. 

On the pages following figures U-7 and U-8, an annotated example 
illustrates remote device and file access from a local program 
running within a local session. 

The Condition Codes for the various MPE File System intrinsics 
retain their normal meanings. Any communications line errors 
will retiim a CCL. In the event of an error, you can call the 
MPE FCHECK intrinsic to determine what happened. When using the 
MPE File System intrinsics for remote file access, the Message 
Block B (File System) error codes apply to the remote file. You 
may also use the MPE PRINTFILEINFO intrinsic to display the 
status of a remote file. 



.'"^^^^ 
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FOPEN Intrinsic 



I BA LV LV IV 

f ilenun : -FO^N ( f ozmaldes ignator , f opt ions , aopt ions , recs ize , 



BA BA IV IV 
device , f ortnmsg , userlabels , blockf actor , 

IV DV IV IV 
numbuf f ers , files ize ,nuinextents , initalloc , 



IV 0-V 
filecode); 



Figure U-7. MPE FOPEN Intrinsic Syntax 
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device 



byte array (optional) 

Contains a string of ASCII characters term- 
inating with any non-alphan\imeric character 
except a slash or period, designating a local 
or remote device on ^ich the file is to 
reside. For a local device the string may 
represent a device class name up to eight 
alphanumeric characters beginning with a 
letter or a logical device number consisting 
of a three-byte numeric string. For a remote 
device the string may represent a DS line 
identifier (the device class name, logical 
device number, or node name that you used when 
establishing the particular communications 
link) followed by a # followed by the device 
class name or logical device number of the 
desired remote device. 

The format of the array referenced by device 
is as follows: 

dsdevice#device 

where dsdevice is the device class name, 
logical device number, or node name that you 
used irtien establishing the particular 
communications link (this specifies the 
physical line coxmecting the two computers). 
The dsdevice class names and logical device 
numbers are defined and assigned to devices 
and communications interfaces during system 
configuration. Node names are defined in a 
Network Configuration data base, where each 
name is logically associated with a 
communications interface and a remote node 
address. 

. . • and where device is the device class name 
or logical device number of the desired remote 
device as established within the remote HP 
3000. If the file is a newly-created disc 
file and the device specification is a device 
class, then all extents of the file are 
restricted to members of the class. 
Similarly, if the device specification is a 
logical device number, then all extents are 
restricted to the specified logical device. 

Default: Local DISC and remote DISC. 



/^ 



Figure U-8. Pertinent Parameter for MPE FOPEN Intrinsic 
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Example 

The following program illustrates how remote files can be 
accessed by using file system intrinsics. 



$CONTROL USLINIT,ADR«MAP,CODE 
BEGIN 
INTEGER 

A, 

I:=-l, 

RDISCNUM, 

RLPNUM; 

byte array rmrlp'filnam(0:3) :="rlp "; 

byte array rlpdev(0:11) ; 

byte array rmtdisc'filnam(0:5) :="rdisc "; 

byte array msg{0:71); 

byte array rdiscdev(0:11) ; 

logical array lmsg(*)=msg; 

^^ intrinsic print,read,fopen,fwritedir,freaddir,fwrite.fclose; 

<<k:gin outer block» 

MOVE MSG:=" input REMOTE DISC DEVICE CLASS NAME "; 
PRINT(MSG,-35,0); 

MOVE MSG:="IN THE FORM .. DSDEVICE#DISCDEV "; 
PRINT (MSG, -31,0); 
A:=READ(LMSG,-12); 
r^ MOVE RDISCDEV:=MSG,(A); 

MOVE MSG:=" INPUT REMOTE LP DEVICE CLASS NAME "; 

PRINT(MSG,-33,0); 

MOVE MSG:="IN THE FORM .. DSDEVICE#LPDEV "; 

PRINT (MSG» -29,0); 

A:=READ(LMSG,-12); 

MOVE RLPDEV:=MSG,(A); 

MOVE MSG:="OPENING REMOTE DISC FILE "; 
PRINT(MSG,-2U,0); 

RDISCNUM : =FOPEN (RMTDISC ' FILNAM , 1* , 5&10l» , -80 .RDISCDEV) ; 
«NEW,ASCII>> 
IF <> THEN 
BEGIN 

MOVE MSG:="COULD NOT OPEN REMOTE DISC FILE "; 

PRINT(MSG,-31,0); 

GO TO OUT; 
END; 
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MOVE MSG:="MRITIMG TO REMOTE DISC FILE "; «IKITIALIZE DISC 

FILE>> /sss^ 

PRINT(MSG,-27,0); 1 

MOVE MSG:=" "; "^ 

MOVE MSG(1):=MSG(0),(71); 

WHILE (I:sl-fl) <10 DO 
BEGIN 

MOVE MSG:="REMOTE FILE ACCESS TEST "; 

FWRITEDIR (RDISCNUM , LMSG , 36 .DOUBLE ( I ) ) ; < <RECORD TO BE 

VJRITTEN>> 
IF THEM 
BEGIN 

MOVE MSG:= "ERROR WHEN WRITING TO REMOTE DISC "; 
PRINT (MSG,-33»0); 
GO TO OUT; 
END; 
END; 

MOVE MSG:="OPENING REMOTE LP FILE "; 
PRINT(MSG,-22,0); 

RLPNUM : =FOPEN (RMTLP ' FILNAM , U , 1 . ,RLPDEV) ; 
IF <> THEN 
BEGIN 

MOVE MSG:="COULD NOT OPEN REMOTE LP FILE "; 
PRINT (MSG,-29,0); 
END; 



I:=-l; «READING REMOTE DISC» 

WHILE (I:= + 1) < 10 DO 
BEGIN 

FREADDIR (RDISCNUM , LMSG , 36 .DOUBLE ( I ) ) ; 
IF THEN 
BEGIN 

MOVE MSG:="COULD NOT READ REMOTE DISC FILE "; 
PRINT (MSG, -31,0); 
END; 
FWRITE (RLPNUM , LMSG , 36 , ) ; 
IF THEN 
BEGIN 

MOVE MSG: = "COULD NOT PRINT TO REMOTE LP FILE "; 
PRINT(MSG,-3U,0); 
END; 
END; 

OUT; 
END. 
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PROGRAM-TO-PROGRAM 
COMMUNICATIONS 



SECTION 



In the preceding sections, you have seen how you can establish 
commxmications links between several HP 3000 computers to form a 
telecommunications network and how you can execute programs in 
any of the HP 3000s from a single log-on terminal. Furthermore, 
you have seen that programs ruiming within any HP 3000 in the 
network can, under the proper circumstances, obtain access to any 
of the hardware or software resources available throughout the 
network. At this point, you already have a powerful telecommuni- 
cations network capability at your disposal. But if you stopped 
here, there would be some very important features missing — 
features that make DSN/DS a complete teleprocessing tool. 

For most teleprocessing applications, it is essential that 
separate user programs be able to be run simultaneously in 
separate computers within the network and that they be able to 
communicate efficiently with one another. 

Two capabilities answer that need: DSN/DS Program -to -Program 
(PTOP) Communications (described in this section) and Inter- 
process Communications (IPC) (described in Section VII), 

You might ask, "Vfliy can't the normal process -handling capabili- 
ties of MPE be used for this purpose?" As you probably recall, 
the process -handling capabilities of MPE permit a user process 
(referred to as the "father'* process), to create and activate one 
or more "son" processes that then run concurrently with the 
father process. Father and son processes can coramtmicate 
efficiently with one another through the use of the SENDMAIL 
intrinsics, shared extra data segments, or a shared user file. 
Unfortunately, however, the process -handling capabilities of MPE 
were designed for use within a single processor. They cannot 
handle the intervention of a commxmications line between father 
and son processes. 

Suppose you were to log on to an HP 3000, gain access to a DS 
line, and initiate a remote session. Within the local session, 
you use a STREAM command to initiate the execution of a program 
named PROGA; and within the remote session, you use a STREAM 
command to initiate execution of a program named PROGB. You now 
have two programs executing simultaneously: PROGA in your local 
HP 3000 and PROGB in the remote HP 3000. 
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At this point, the two programs are entirely independent of one 

another: neither knows the other exists. If you add a ^,^,5^ 

sharedaccess disc file to the situation, PROGA and PROGB can now j 

read from and write to that file, and thereby communicate ^ 

indirectly with one another. This arrangement works well as long 

as the data being deposited in the shared file does not have to 

be retrieved, processed, and responded to within a finite period 

of time. 

There are teleprocessing applications where this type of 
arrangement is not only adequate but makes a great deal of sense. 
For example, consider the case where a branch office is 
accumulating information that must be merged once a day into a 
data base residing at the main office. In this case, the two 
programs can make very effective use of the message file 
approach. 



As soon as an application tries to be truly interactive, however, 
this arrangement falters because the two programs cannot 
communicate directly. Each must know whether or not the other 
program is trying to transmit data. The more dependent each 
program is upon receiving data from the other, the more likely it 
is that PTOP should be used for the application. 



/^^ 



With the remote file access method of program-to -program 

communication, the two programs had no way of knowing if the 

other program was actually executing. With the POPEN intrinsic, 

the master program knows that the slave program is executing, ^"^ 

because it created and activated the slave program's process. ) 

Likewise, the slave program knows that the master program is 

executing, because without an active corresponding master 

program, the slave itself would not be executing. 

The DSN/DS program-to-program communications facility provides 
nine intrinsics that make it possible for two or more user 
programs residing in separate HP 3000s to exchange data and 
control information directly (and efficiently) over DSN/DS 
communications links. 

The nature of any two programs that are communicating with one 
another in this manner is not sjrmmetrical. One of them (referred 
to as the "master" program) is always in control and is the one 
that initiates all activity between the two programs. The other 
(referred to as a "slave" program) always responds to requests 
received from the master. Those intrinsics used within a master 
program are summarized in table 5-I, and those used within a 
slave program are summarized in table 5-2. 
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Table 5"1» Master Program- to -Program Intrinsics 



^p\, 



Intrinsic 
Name 


Ftmction 


POPEN 


Initiates and activates a slave process 
in a remote HP 3000 and initiates 
program -to -program communication with the 
slave program. 


PREAD 


Sends a read request to the remote slave 
program asking the slave to send a block 
of data back to the master. 


PWRITE 


Sends a block of data to the remote slave 
program. 


PCONTROL 


Transmits a tag field (containing user- 
defined control information) to the 
remote slave program and receives a tag 
field back from the slave. 


PCLOSE 


Terminates (kills) the remote slave 
program's process. 


PCHECK 


Returns an integer code specifying the 
completion status of the most recently 
executed master program-to-program 
intrinsic. 



/0^s 
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Table 5-2. Slave Program-to-Program Intrinsics 



Intrinsic 
Name 


Fimction 


GET 


Receives the next request from the remote 
master program • 


ACCEPT 


Accepts (and completes) the request 
received by the preceding GET intrinsic 
call. 


REJECT 


Rejects the request received by the 
preceding GET intrinsic call. 


PCHECK 


Returns an integer code specifying the 
completion status of the most recently 
executed slave program- to -program 
intrinsic. 



Conceptually, the DSN/DS program -to -program intrinsics are very 
similar to the MPE process handling and file system intrinsics 
that are used for process -to-process communication within a 
single-system environment. Table 5-3 compares the intrinsics 
used for process-to-process communication within a single-system 
environment to those used for program-to-program communication 
within a distributed systems environment. 
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Table 5"3^ Single System / Distributed Systems Comparison 



/#^. 



#^ 






/|P*V 



Function 


Single System 


Distributed Systems 




(Process Handling) 


(Program-to-Program) 


Initiate 


CREATE 


POPEN 


another 


ACTIVATE 




process. 






Communi- 


Mail Intrinsics: 


Master (father) Requests: 


cate with 






the other 


SENDMAIL 


PREAD 


process ♦ 


RECEIVEMAIL 


PWRITE 




• 


PCONTROL 




• 


PCHECK 




User Matnaged Extra 


Slave (son) Responses: 




Data Segment: 


GET 




GETDSEG 


ACCEPT 




DMOVEIN 


REJECT 




DMOVEOUT 

• 
• 


PCHECK 




• 
Shared User File: 






FOPEN 






FREAD 






FWRITE 






FCONTROL 






FCLOSE 






FCHECK 

• 
• 




Terminate 


Father: 


Master (father): 


the other 






process. 


KILL (a son) 


PCLOSE (a slave) 




TERMINATE (self 


TERMINATE (self 




and all sons) 


sind all slaves) 
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When a DSN/DS communications link exists between two HP 3000s, a 

user program (the master program) can create and activate a son /^^ 

process (a slave program) in the remote HP 3000. The POPEN / 

intrinsic performs this function, in place of the standard HPE 

CREATE and ACTIVATE intrinsics. 

After the master and slave programs are both executing, the 
master program can: 

• Send data (PWRITE) or control information (PCONTROL) directly 
to the slave program 

• Send a read request (PREAD) or control request (PCONTROL) to 
the slave program asking that the slave send data or control 
information back to the master 

m Check status (PCHECK) and terminate (PCLOSE) a slave program. 

Notice the striking similarity between this method of ^ 

communication and the use of the MPE File System intrinsics FREAD 

and FWRITE. It is as though the master program is reading from 

or writing to a file --a very intelligent file that is capable 

of making decisions, controlling input/output devices, and 

performing productive processing. 



''^ 



/**^K 
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JPN 
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PTOP INTRINSICS 



The following pages contain detailed descriptions of the PTOP 
intrinsics that were summarized in tables 5*1 and 5"2. For 
convenience in locating specific items of information in this 
reference section, these detailed descriptions are presented in a 
format consistant with that used in the MPE Intrinsics Reference 
Manual. Also, since this part of the section will be used for 
repeated reference, the intrinsics are arranged in alphabetical 
sequence, rather than in the order of normal usage as they were 
presented in the suimnary tables. 



To call a DSN/DS PTOP intrinsic from an SPL program, use the 
following procedure: 

1. Refer to the intrinsic description to determine the 
parameter types and their positions in the parameter list. 

2. Declare the variables or array names to be passed as 
parameters by type at the beginning of the prograim. 

3. Include the name of the PTOP intrinsic in an INTRINSIC 
declaration statement. 

k* Issue the intrinsic call at the appropriate place in your 
program. 



j^^\ 

r 
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ACCEPT 



(Slave callable) Accepts (and completes) the 

request received by the pre- 
ceding GET intrinsic call and 
returns an optional tag field 
back to the remote master 
program. 



lA lA IV 0-V 
ACCEPT ( itag , target , t count ) ; 



PARAMETERS 



itag integer array (optional) 



A twenty-word array used for transmitting a tag 
field. The format of the tag field is defined by 
the user's master and slave programs. 



target integer array (optional) 



An array used for transmitting or receiving blocks 
of data. 

For PREAD requests, this array contains the block 
of data to be transmitted to the master program. 

For PWRITE requests, this array receives the block 
of data from the DSN/DS buffer. 

For POPEN and PCONTROL requests, this parameter 
has no meaning and should be omitted. 



t count integer by value (optional) 



An integer specifying the number of words (if 
positive) or bytes (if negative) to be transmitted 
or received. 
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ACCEPT Intrinsic 



For FREAD requests, this parameter specifies how 
much data is to be transmitted from target to the 
master program. 

For PWRITE requests, this parameter specifies how 
much data is to be moved from the DSN/DS buffer to 
target • 

For POPEM and PCONTROL requests, this parameter 
has no meaning and should be omitted. 



CONDITION CODES 

CCE Request completed successfully. 

CCG (Not returned.) 

CCL An error occurred. Issue a PCHECK intrinsic call 

to determine what happened. 

OPERATION 



The ACCEPT intrinsic accepts the request received by the most 
recent GET intrinsic call, completes the requested operation, and 
transmits an optional tag field back to the remote master 
program. 

In the case of a POPEN request, the ACCEPT call transmits an 
optional tag field (itag) to the remote master program. 

In the case of a PREAD request, the ACCEPT call transmits the 
specified number of words or bytes (tcount) from target to the 
master program and transmits an optional tag field (itag) to the 
master program. 

In the case of a PWRITE request, the ACCEPT call moves the 
specified number of words or bytes (tcount) from the DSN/DS 
buffer to target and transmits an optional tag field (itag) to 
the master program. 

In the case of a PCONTROL request, the ACCEPT call transmits an 
optional tag field (itag) to the remote master program. 
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GET 



(Slave callable) 



Receives the next request from 
the remote master program* 



I lA I I 0-V 
ifun : -GET ( itag , 11 9 ionumber ) ; 



FUNCTIONAL RETURN 



/"^^ 



When the GET intrinsic executes , it returns to the slave program 
a number (ifun) specifying ^at type of request was received from 
the remote master program , as follows: 



ifun 




1 
2 
3 
k 

5 



An error occurred. This value is returned only 
when the condition code CCL is also returned. 
Issue a PCHECK intrinsic call (with a dsnum 
parameter of zero) to determine what happened. 

POPEN request received. 

PREAD request received. 

PWRITE request received. 

PCONTROL request received. 

This value is returned only when the condition 
code CCG is also returned. It indicates that a 
pending MPE File System I/O without wait request 
was completed (instead of the expected remote 
DSN/DS I/O request), ionumber contains the file 
number associated with the completed I/O request. 



>'*^^ 
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GET Intrinsic 

PARAMETERS 

itag integer array (optional) 

A twenty- word array used for receiving a tag 
field. The format of the tag field is defined by 
the master and slave programs* 

il integer (optional) 

A word that has meaning only when a PREAD or 
PWRITE request is received from the master 
program* 

For a PREAD request » il contains an integer 
specifying the number of words or bsrtes requested 
by the master program. 

For a PWRITE request, il contains an integer 
specifying the number of words or bytes 
transmitted from the master program to the DSK/DS 
buffer on the remote system. 

ionumber integer (optional) 

A word that has meaning only when the condition 
code CCG and an ifun of 3 sire returned. In that 
case ionumber contains the MPE File System file 
number associated with the completed I/O without 
wait request. 

Default: No file number is returned. 



CONDITION CODES 



CCE Request received successfully. 

CCG The implicit lOWAIT(O) call issued by the GET 

intrinsic completed a pending MPE File System I/O 
without wait request instead of a DSN/DS remote 
I/O request, ionumber contains the file number 
associated with the completed File System request. 

CCL An error occurred. Issue a PCHECK intrinsic call 

to determine what happened. 
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GET Intrinsic 

OPERATION 



The GET intrinsic receives the next request from the remote 
master program and accepts an optional tag field (available in 
itag). The GET intrinsic call implicitly issues an lOWAIT(O) 
intrinsic call. An ifun of indicates that an lOWAIT error 
occurred. An ifUn of 3 will occur only if you are executing MPE 
File System intrinsic calls without wait in your program and the 
implicit lOWAIT(O) call completes a pending File System I/O 
request instead of the expected DSN/DS remote I/O request (in 
this case you will have to issue another GET call after 
processing the completed File System I/O request in order to 
receive the expected DSN/DS remote I/O request) . 



NOTE 



You must not use lOWAIT(O) calls within a program 
containing DSN/DS GET calls. If you were to use an 
lOWAIT(O) call and it responded to a DSN/DS remote I/O 
request, your program would not be able to msike any sense 
out of the information returned by the lOWAIT call. 
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PCHECK 



f^ 



Returns an integer code speci- 
fying the completion status of 
the most recently executed 
DSN/DS program-to-program in- 
trinsic. 



(Slave and Master callable) 



I IV 

icode : =PCHECK ( dsnum ) ; 



FUNCTIONAL RETURN 



When the PC3IECK intrinsic is executed, it returns to the 
calling program a number (icode) that specifies the completion 
status of the most recently executed DSN/DS program-to- 
program intrinsic. The various values of icode are shown in 
Appendix B imder the heading "DSN/DS Functional Errors**. 



PARAMETERS 



dsnum 



integer by value (required) 



MASTER PROGRAM: 



SLAVE PROGRAM: 



The link identifier returned 
by the particular POPEN in- 
trinsic that initiated commim- 
ication with the remote slave 
program! • 



(zero); no link 
is returned to 
program. 



identifier 
a slave 
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PCHECK Intrinsic 

CONDITION CODES 

CCE PCHECK request successfully completed. 

CCG (Not returned.) 

CCL PCHECK request denied because dsnum was invalid. 

OPERATION 



The PCHECK intrinsic returns an integer value that specifies the 
completion status of the most recently executed DSN/DS program- 
to-program intrinsic. 



y''^ 
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PCLOSE 



r 



Terminates program-to-program (Master callable) 

communication with a remote 
slave program. 



IV 
PCLOSE (dsnum); 



PARAMETERS 



dsnum integer by value (required) 



The line number returned by the particular POPEN 
intrinsic call which initiated communication with 
the remote slave program. 



CONDITION CODES 

CCE Successful completion. 

CCG (Not returned.) 

CCL Request denied; an error occurred. Issue a PCHECK 

intrinsic call to determine what happened. 



OPERATION 



The PCLOSE intrinsic terminates the remote slave process 
associated with dsnum. The particular communications line 
remains open. 
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PCONTROL 

(Master callable) 



Exchanges tag fields with the 
remote slave program. 



IV lA 0-V 
PCONTROL ( dsnum , itag ) ; 



PARAMETERS 



dsnum 



itag 



integer by value (required) 

The link identifier returned by the particular 
POPEN intrinsic call which initiated communication 
with the remote slave program. 



integer array (optional) 

A twenty-word array used for transmitting and 
receiving a tag field. The format of the tag 
field is defined by the master and slave programs 
and may serve any purpose you desire. 



/fs^^ 



CONDITION CODES 



CCE 
CCG 
CCL 



Request accepted by remote slave program. 

Request denied by remote slave program. 

Request denied; an error occurred. Issue a PCHECK 
intrinsic call to determine what happened. 



^ 
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PCONTROL Intrinsic 



OPERATION 



The PCONTROL intrinsic transmits a tag field to the remote slave 
program and accepts one in return. The remote slave program must 
issue a GET intrinsic call followed by either an ACCEPT or REJECT 
call to complete the PCONTROL operation. Both the ACCEPT and 
REJECT calls transmit a tag field back to the master program. 

Although this intrinsic was designed specifically for the 
exchanging of tag fields, you will notice that itag is an 
optional parameter (it is also optional for the ACCEPT and REJECT 
slave program-to-program calls). If the master program did not 
transmit a tag field, the returned tag field (if any) is not 
accessible. 



The PCONTROL activity is illustrated in figure 5-I. 



/^Pn 



^^^\ 





MASTER 


Send control request and optional 
tag field. 


SLAVE 












GET 


1 


HCON 1 HOL 


Send optional ^^Ss^ 

tag field. N>^v.^^^ 










DSN/DS 
BUFFER 












ACCEPT 










or 




REJECT 

















Figure 5-1- PCONTROL Activity 



j^^\ 
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POPEN 



(Master callable) 



Initiates program-to-program 
communication with a remote 
slave program. 



I BA BA lA BA IV 

dsnura : =POPEN ( dsdevice , progname , itag , entryname , parara » 

LV IV IV IV IV 0-V 
flags » stacks ize , dls ize .maxdata »buf s ize ) ; 



^'^^^ 



FUNCTIONAL RETURN 



When the POPEN intrinsic executes, it returns to the master 
program a nvunber (dsnum) by which DSN/DS uniquely identifies the 
particular commxmications link. This number is analagous to the 
file number returned by the MPE FOPEN intrinsic in that it is 
used in all subsequent master program-to-program intrinsic calls 
to reference the remote slave program. 



PARAMETERS 



dsdevice byte array (required) 

Contains a string of ASCII characters terminated 
by a space. This string must be the device class 
name, logical device number, or node name used in 
the DSLINE or REMOTE HELLO command that opened the 
communications line you will be using. 



progname byte array (required) 

Contains a string of ASCII characters terminated 
by a space. This string is the name (with optional 
group and account names) of an MPE program file 
(residing on a disc connected to the remote HP 
3000) containing the remote slave program. 
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POPEN Intrinsic 



itag integer array (optional) 



A twenty- word array that is used for transmitting 
and receiving tag fields. The format of the tag 
field is defined as part of the user's 
application. 

Default: A tag field of all zeros is sent; the 
returned tag field (if any) is not 
available to the master program. 



entryname byte array (optional) 



Contains a string of ASCII characters terminated 
by a space. This string is the name of the entry 
point (label) at which execution of the remote 
slave program is to begin. 

Default: Primary entry point. 



param integer by value (optional) 



A word used to transfer control information to the 
new (remote) process. Any instruction in the 
outer block of code in the new process can access 
this information in location Q-U. 

Default: Word is filled with zeros. 



flags logical by value (optional) 



A word whose bits, if on, specify the loading 
options for the slave program: 



NOTE 



Bit groups are denoted using the standard 
SPL notation. Thus bit (1^:1) indicates 
bit 15, bits (10:3) indicates bits 10,11, 
and 12. 



Bit (15:1) - (Always set on.) 



Bit(ll*:l) - LOADMAP bit. If on, a listing of 
the allocated (loaded) program is produced on 
the job/session list device. This map shows 
the Code Segment Table (CST) entries used by 
the new process. If off, no map is produced. 

Default: Off. 
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Bit(13:l) - DEBUG bit. Bit must be off (0) — 
no breakpoint can be set. 



Default: Off. 



Bit (12:1) - If on, the slave program is loaded 

in non-privileged mode. If this bit is off, 

the program is loaded in the mode specified 
Tdien the program file was prepared. 

Default: Off. 



Bits (10: 2) - LIBSEARCH bits. These bits denote 
the order in which remote libraries are to be 
searched for the slave program: ^^ 

00 - System Library. 

01 - Account Public Library, followed by System 

Library. 
10 - Group Library, followed by Account Public 
Library and System Library. 

Default: 00. 



Bit(9:l) - NOCB bit. If on, file system control 
blocks are established in an extra segment. If 
off, control blocks may be established in the 
Process Control Block Extension (PCBX) area. 

Default: Off. 



NOTE 



This bit should be set on if the slave 
program uses a large stack. 



Bits (7: 2) - Reserved for MPE. Should be set to 
zero. 



Bits (5: 2) - STACKDUMP bits. Bits must be off 
(00). 

Default: 00 



Bit(U:l) - Reserved for MPE. Should be set to 
zero. 
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JJJPP^*^!. 



NOTE 



The following bits {0:k) are ignored, 
because the bit pair (5:2) must be 00. 



i^^\ 



Bit(3:l) - DL to QI bit. If on, the portion of 
the stack from DL to QI is dumped. If off, this 
portion of the stack is not diunped. 

Default: Off. 



Bit (2:1) - QI to S bit. If on, the portion of 
the stack from QI to S is dumped. If off, this 
portion of the stack is not dumped. 

Default: Off. 



Bit (1:1) - Q-63 to S bit. If on, the portion of 
the stack from Q-63 to S is dumped. If off, 
this portion of the stack is not dumped. 

Default: Off 



^i\ 



stacks ize 



dlsize 



integer by value (optional) 

An integer (Z - Q) denoting the number of words 
assigned to the local stack area bounded by the 
initial Q and Z registers. 

Default: The same as that specified in the program 
file. 



integer by value (optional) 

An integer (DB - DL) denoting the number of words 
in the user-managed stack area bounded by the DL 
and DB registers. 

Default: The same as that specified in the program 
file. 



maxdata 



^^\ 



integer by value (optional) 

The maximum size allowed for the process' stack 
(Z-DL) area in words. VDien specified, this value 
overrides the one established at program- 
preparation time. 
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Default: If not specified, and not specified in 
program file either, MPE assumes that 
the stack will remain the same size. 



bufsize integer by value (optional) 



The size in words of the communications buffer 
(DSN/DS buffer) that is to be established by the 
remote DSN/DS software. Note that this parameter 
defines the maximum niamber of words of data that 
can be transmitted by a PWRITE or PREAD intrinsic 
call. 

Default: Same size as the line buffer defined by 
the DSLINE command (LINEBUF^") for the 
first DSLINE issued to the dsdevice. 
Will never be smaller than 30U words. 

If no LINEBUF= is specified by the first 
DSLINE command, then the default 
configuration length is used. 



CONDITION CODES 

CCE Request accepted by remote slave program. 

CCG Request rejected by remote slave program. 

CCL Request denied; an error occurred. Issue a PCHECK 

intrinsic call to determine what happened. 

OPERATION 



The POPEN intrinsic creates and activates a process in the remote 
HP 3000 for the specified remote slave program (progname) and 
optionally transmits a tag field (itag) to that remote slave 
program. The remote slave program must issue a GET intrinsic 
call followed by either an ACCEPT or REJECT call to complete the 
POPEN operation. The remote slave program may transmit a tag 
field back to the master program as part of an ACCEPT or REJECT 
call. If the master program transmitted a tag field, then the 
returned tag field (if any) is available in itag. If the master 
program did not transmit a tag field, then the returned tag field 
(if any) is not accessible. 



/*^^ 
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The bufslze parameter specifies the length in words of an area to 
be established by the remote DSN/DS software as a communications 
buffer. This buffer is established implicitly as part of the GET 
call that receives the POPEN request. 



/^^ 



NOTE 



The master program is limited to one 
slave program on each line. Thus^ 
only one POPEN (to a given node) is 
permitted. After a POPEN intrinsic 
call, the remote slave program 
remains activated, and both the 
communications link and the DSN/DS 
buffer remain intact, even if the 
POPEN request is rejected by the re- 
mote slave program. The meaning of a 
POPEN reject by the remote slave 
program must be established as part 
of the design of the user's applica- 
tion. 



The POPEN activity is illustrated in figure 5-2. 



j^^\ 
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MASTER 


1 ) Create end activate a process for 
the remote slave program. 

2) Send optional tag field. 

3) Send DSN/DS buffer size. 


SLAVE 






GET 

(establish the DSN/DS 

communications buffer) 






Smd optionat ^v 
tag field. Vv 








DSN/DS 
BUFFER 








ACCEPT 










or 






REJECT 





Figure 5-2. POPEN Activity 
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PREAD 



(Master callable) 



Asks the remote slave program 
to send a block of data* 



-^^'^^ 



I IV lA IV lA 0-V 

Igth : =PREAD (dsnum , target »t count , itag ) ; 



FUNCTIONAL RETURN 



z*^^ 



The PREAD intrinsic returns a positive integer value showing the 
length of the information transferred. If the t count parameter 
in the PREAD call was positive, the positive value returned 
represents a word count; if the tcount parameter was negative, 
the positive value returned represents a byte count. 



/-<*%. 



PARAMETERS 



dsnxam 



integer by value (required) 

The link identifier returned by the particular 
POPEN intrinsic call which initiated communication 
with the remote slave program. 



-^^^ 



target 



integer array (required) 

The array into which data received from the remote 
slave program will be deposited. 



tcount 



integer by value (required) 

The requested number of words (if positive) or 
bytes (if negative) of data. 



yrt^ 
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^^ 



itag integer array (optional) 



/^^^ 



A twenty-word array used for transmitting and 
receiving a tag field. The format of the tag 
field is defined by the master and slave programs 
and may serve auiy purpose the user desires. 



CONDITION CODES 

CCE Request accepted by remote slave program. 

CCG Request denied by remote slave prograon. 

CCL Request denied; an error occurred. Issue a PCHECK 

intrinsic call to determine what happened. 

OPERATION 



The PREAD intrinsic transmits a read request to the remote slave 
program and optionally transmits a tag field from itag to the 

r remote slave program. The remote slave program must issue a GET 

intrinsic call followed by either an ACCEPT or REJECT call to 
complete the PREAD operation. The GET call moves the tag field 
from the master program into the itag field provided in the 
remote slave program. The ACCEPT call moves the requested block 
of data from the remote program's data buffer into the target in 
the roaster program ^ aind it also sends the optional itag back to 
the master program. The REJECT call transmits no data; it only 
returns the optional tag field. If the master prograim did not 
transmit a tag field, the returned field (if any) is not 
accessible. 

The PREAD activity is illustrated in figure 5-3* 
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MASTER 




SLAVE 














GET 






TARGET 




'**-**^ 


Send read request, optional 
tag field, and data. 




USER'S 
BUFFER 


-- 


SendVss. 

optional \\,,,^ 

itao field. \ ^^^-^-.....^^^^^ 






ACCEPT 

(Send data from user't 

buffer to remote master 

program) 





















USER'S 
BUFFER 










\ 


or 








^ 


REJECT 

(no data transmitted) 























Figure 5-3. PREAD Activity 
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PWRITE 



i^!^_ 



Sends a block of data to the 
remote slave program. 



(Master callable) 



IV lA IV lA 0-V 
PWRITE (dsnum, target, tcount^itag) ; 



PARAMETERS 



^^\ 



dsxiiim 



integer by value (required) 

The link identifier returned by the particular 
POPEN intrinsic call which initiated communication 
with the remote slave program. 



target 



J^N 



integer array (required) 

The array from which data will be transmitted to a 
remote slave program. 



tcount 



/#^ 



itag 



integer by value (required) 

The requested number of words (if positive) or 
bytes (if negative) of data. 



integer array (optional) 

A twenty-word array used for transmitting and 
receiving a tag field. The format of the tag 
field is defined by the master and slave programs 
and may serve any purpose the user desires. 



CONDITION CODES 



i^^N, 



CCE 
CCG 
CCL 



Request accepted by remote slave program. 

Request denied by remote slave prograim. 

Request denied; an error occurred. Issue a PCHECK 
intrinsic call to determine what happened. 
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OPERATION 



The PWRITE intrinsic transmits a block of data (number of words = 
t count) from target to the DSN/DS buffer in the remote HP 3000, 
transmits a m*ite request to the remote slave program, and 
optionally transmits a tag field from itag to the remote slave 
program. The remote slave program must issue a GET intrinsic call 
followed by either an ACCEPT or REJECT call to complete the 
PWRITE operation. The GET call moves the tag field from the 
master program into the itag field provided in the remote slave 
program, and it also moves the data across the line into the 
DSN/DS data buffer. The ACCEPT call moves the data from the 
remote DSN/DS buffer into the remote slave program's buffer, and 
it also sends the optional itag back to the master program. The 
REJECT call refuses the write request (the data in the DSN/DS 
buffer is no longer accessible to the slave program) and returns 
the optional tag field to the master program. 



The PWRITE activity is illustrated in figure 5-U, 
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Figure 5-U. PWRITE Activity 



/<«S^ 



5-28 



REJECT 



i^pfN 



Rejects the request received 
by the preceding GET intrin- 
sic call and returns an 
optional tag field back to 
the remote master program. 



(Slave callable) 



lA 0-V 
REJECT(itag); 



i^^PS 



PARAMETERS 



itag 



/«N 



integer array (optional) 

A twenty-word array used for transmitting a tag 
field. The format of the tag field is defined by 
the user's master and slave programs. 



CONDITION CODES 



i#^ 



CCE 

CCG 
CCL 



Response transmitted successfully to the remote 
master program. 

(Not returned.) 

An error occurred. Issue a PCHECK intrinsic call 
to determine what happened. 



OPERATION 



The REJECT intrinsic rejects the request received by the most 
recent GET intrinsic call and transmits an optional tag field 
(itag) back to the remote master program. 



0^^ 
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INTERFACING WITH COBOL AND BASIC 



Access to the program-to-program communications capability is 
available to ANS COBOL (COBOL/I) and BASIC users only through 
interface routines. DSN/DS COBOL Interface is covered in 
Appendix F, and DSN/DS BASIC Interface is covered in Appendix G. 

It is not necessary to use the DSN/DS COBOL Interface with COBOL 
11/3000, however. 



PTOP EXAMPLE 



This example shows how two programs can commtinicate with one 
another by using the master and slave program-to-rprogram 
intrinsics. The comments included within each program tell vh&t 
is happening. 



Master Program 

1 (CONTROL USLINIT,ADR,MAP,CODE 

2 BEGIN 
3 
U COMMENT 

5 NAME OF PROGRAM IS MASTERP(S). 

6 THE SOURCE IS MASTERS. 

7 THIS PROGRAM IS TO BE RUN ON THE MASTER CPU. IT 

8 WILL START THE "SLAVE" PROGRAM ON THE SLAVE CPU. 

9 THE PROGRAM WILL THEN RECEIVE A KNOWN TEST PATTERN 

10 FROM THE USER TERMINAL, WRITE IT TO THE REMOTE DISK 

11 FILE, READ IT BACK, AND PRINT IT ON THE LOCAL LP. 

12 THE TRANSFER OF DATA IS DONE THRU PTOPC. ; 
13 

lU 

15 INTEGER 

16 ERROR, 

17 LINE'NUM, 

18 I, 

19 J, 

20 LPDEV'NUM; 
21 

22 BTOE ARRAY DS 'DEVICE (0:6):=" "; 

23 BYTE ARRAY LPDEV(0:2):="LP "; 

2U BYTE ARRAY LPFILE(0:6):="LPFILE "; 

23 BYTE ARRAY MSG(0:79); 

26 BYTE ARRAY PROG'NAME(0:19):="SLAVEP. PUB. SUPPORT "; 

27 ^ 

28 / 

29 LOGICAL ARRAY IOBUF(0:39); 
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30 LOGICAL ARRAY ITAG(0:19) :=20(%0200UO) ; 

r31 LOGICAL ARRAY MSGW(*)=MSG; 

32 LOGICAL ARRAY DS'DEVW(*)=DS' DEVICE; 
33 
3U 

35 INTRINSIC DEBUG,FCLOSE,FOPEM,FWRITE,PCONTROL; 

36 INTRINSIC PCLOSE,POPEN,PREAD, PRINT, FWRITE»READ; 

37 

38 MOVE MSa:=" INPUT NAME OF DSDEVICE"; 

39 PRINT(MSGW,-28,0); 
UO READ(DS'DEVW,-7); 
Ul 

k2 MOVE MSG:=" POPEN ISSUED"; 

U3 PRINT(MSGW,-18,0); 

UU 

U3 LINE ' NUM : =POPEN (DS ' DEVICE , PROG ' NAME , ITAG ) ; 

1(6 IF <> THEN 

kl 

U8 BEGIN 

k9 PRINT (ITAG,20,0); 

50 ERROR := 1; 

51 GO TO ERR'PROC; 

52 END 

53 ELSE 
5U PRINT(ITAG,20,0); 

55 
56 

57 MOVE MSG:=" POPEN COMPLETED SUCCESSFULLY"; 

58 PRINT(MSGW,-33,0); 

59 

60 LPDEV'NUM:=FOPEN(LPFILE,U,1.UO,LPDEV); 

61 IF <> THEN BEGIN ERROR: =2;G0 TO ERR'PROC; END; 
62 

63 MOVE MSG:="IN PUT TEST RECORD MAX. 80 CHAR"; 

6U PRINT(MSGW,-30,0); 

f 66 MOVE IOBUF:=" "; «CLEAR OUT BUFFER AREA» 

67 MOVE IOBUF(l):=IOBUF,(39); 
68 

69 READ(I0BUF,-80); «GET RECORD TO WRITE » 
70 

71 PWRITE (LINE' NUM, IOBUF,U0); «SEND RECORD TO REMOTE » 

72 IF <> THEN BEGIN ERR0R:=3;G0 TO ERR'PROC; END; 

73 

Jk MOVE MSG:=" DISK FILES BEING XFERRED FROM REMOTE"; 

75 PRINT(MSGW,-1»1,0); 

76 J:=-l; «START READING FROM REMOTE » 

77 WHILE (J:=J+1)<5 DO 

78 BEGIN 

79 MOVE MSG:=" PREAD ISSUED"; 

80 PRINT(MSGW,-19,0); 
81 



r 



0^ 82 MOVE IOBUF:=" "; 



83 MOVE IOBUF(l):=IOBUF,(39); 
8U 
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85 I:=PREAD(LINE'NUM,IOBUF,U0,ITAG); ^„^^ 

86 IF = THEN 7 

87 BEGIN 

88 IF J=U THEN 

89 BEGIN 

90 HOVE MSG:=" ALL DISK RECORDS XFERRED"; 

91 PRINT(MSGW,-29,0); 

92 END; 

93 END 
9k ELSE 

93 I^GIN ERROR:°U;GO TO ERR'PROC; END; 

96 FWRITE(LPDEV'NT]M,IOBUF,I,0); 

97 IF <> THEN BEGIN ERROR: sU;GO TO ERR'PROC;END; 

98 END; 

99 

100 FCLOSE(LFDEV'Nl)M,0,0); 

101 PCLOSE(LINE'NUH); 

102 IF THEN BEGIN ERROR: =5;G0 TO ERR'PROC;END; ^^ 

103 MOVE MSG:s"END OF MASTER PROGRAM"; 1 
lOlt PRINT(MSGW,-21»0}; GO TO END 'IT; 

105 

106 ERR'PROC: «HANDLE ERROR CONDITIONS» 

107 DEBUG; 

108 FCLOSE(LPDEV'NUM,0,0); 

109 PCLOSE(LINE'NUM); 

110 MOVE MSG: -"ERROR, END MASTER PROGRAM"; 

111 PRINT(MSGW,-25,0); 
112 
113 END' IT: END. 



Slave Program 

1 $CONTROL USLINIT, ADR .MAP, CODE ^ 

3 BEGIN 

U COMMENT 

5 THE. NAME OF THIS PROGRAM IS SLAVEP(S). 

6 THE NAME OF THE SOURCE IS SLAVES. 

7 THIS PROGRAM IS TO BE COMPILED AND PREP'ED ON THE 
6 SLAVE HP3000 SYSTEM. IT WILL BE INITIATED FOR RUN 
9 B7 THE MASTER. THE FUNCTION OF THIS PROGRAM IS TO 

10 LOAD A DISK FILE WITH KNOWN TEST PATTERNS THAT WILL 

11 BE TRANSFERRED TO THE MASTER AND PRINTED ON THE 

12 MASTER'S LINE PRINTER; 

13 
lU 

15 IN^ISGER 

16 ERROR, 

17 DISK'FILENUM, 

18 I, 

19 IL. 

20 lONUHBER, 
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21 J; 

22 

23 BITE ARRAY MSG(0:79); 

2U BYTE ARRAY TEST(0 :!♦):= "TEST "; 

25 

26 LOGICAL ARRAY DISK ' BUF ( : 39 ) ; 

27 LOGICAL ARRAY ITAG ( : 19 ) : =7 ( 0200U0 ) ; 

28 LOGICAL ARRAY MSGW(*)=MSG; 

29 

30 INTRINSIC FOPEN,DEBUG,FWRITEDIR,FREADDIR,FCLOSE; 

31 INTRINSIC GET,ACCEFT,PRINT,READ,REJECT; 
32 

33 

3U IL:»UO; 

35 MOVE HSG:="ISSUING A GET (REMOTE)"; 

36 PRINT(MSGW,-22,0); 

37 I:=GET(ITAG); «(ffiT FOR POPEN» 

38 IF < THEN 

39 BEGIN 

^0 MOVE ITAG:«"ERROR ON GET:POPEN"; 

Ul GO TO ERR 'OPEN; 

U2 END; 

U3 

kk IF 1=1 THEN 

k5 BEGIN 

U6 MOVE MSG:="POPEN RCVD. . .ISSUING AN ACCEPT (REMOTE)"; 



J^ kj PRINT(MSGW,-39.0); 



ltd END; 

^9 

50 MOVE ITAG:="POPEN ACCEPT SUCCESSFUL (REMOTE)"; 

51 ERR 'OPEN; 

52 ACCEPT ( ITAG) ; «ACCEPT FOR POPEN» 
53 

5U DISK'FILENUM:=FOPEN(TEST,U,%10U,-80,.,,1.1,10D); 

55 IF <> OHEN BEGIN ERROR: =1;G0 TO ERR'PROC; END; 
56 

57 I:=GET; <<TEST REC FROM MASTER>> 

58 IF <> THEN BEGIN ERR0R:=2; GO TO ERR'PROC; END; 

59 IF 1=3 THEN «PWRITE RECEIVED» 

60 BEGIN 

61 ACCEPT ( .DISK 'BUF); 

62 IF <> THEN BEGIN ERR0R:=3; GO TO ERR'PROC; END; 

63 END; 
6k 

65 

66 I:=-l; «START WRITING TEST FILE>> 

67 WHILE(I:=I+1) < 5 DO 

68 BEGIN «WRITE REC TO DISK» 

69 FWRITEDIR (DISK ' FILENUM .DISK ' BUF , UO .DOUBLE ( I ) ) ; 

70 IF <> THEN BEGIN ERROR:=U; GO TO ERR'PROC; END; 
71 

jm^ 72 END; «END WRITING TEST FILE» 
f" 73 

7k J:=-l; «SEND DISK FILE TO MASTER» 

75 WHILE(J:=J+1)<5 DO 
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76 BEGIN 

77 MOVE MSG:="ISSUING A GET (REMOTE)"; 

78 PRINT (MSGW, -22,0); 

79 I:=6ET(ITAG,IL,I0NUMBER); 

80 IF < THEN BEGIN ERROR: =3: GO TO ERR'PROC; END; 

81 IF 1=2 THEN 

82 BEGIN 

83 MOVE MSG:="PREAD RCVD.., ISSUING AN ACCEPT 
(REMOTE)"; 

8I4 PRINT (MSGW, -39,0); 

83 END 

86 ELSE 

87 BEGIN ERR0R:=6;G0 TO ERR'PROC; END; 

88 MOVE DISK'BUF:=Jt0200U0; 

89 MOVE DISK'BUF(1):=DISK'BUF(0),(39); 

90 FREADDIR (DISK ' BUF , UO ,DOUBLE ( J) ) ; 

91 IF THEN BEGIN ERR0R:=7;G0 TO ERR'PROC; END; 

92 ACCEPT ( ITAG , DISK ' BUF , Uo ) ; ^ 

93 IF THEN BEGIN ERR0R:=8;G0 TO ERR'PROC; END; ' 
9h END; 

95 

96 FCLOSE(DISK'FILENUM,0,0); GO TO END' IT; 

97 

98 ERR'PROC: «HANDLE ERROR CONDITIONS » 

99 DEBUG; «WILL PROMPT OT MASTER SIDE TERMINAL » 

100 REJECT; 

101 I:=GET; «ALLOW PCLOSE» ^ 

102 GO TO ERR'PROC; ' 
103 

lOU END' IT: END; 
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NETWORK FILE TRANSFER 



SECTION 



VI 



The Network File Transfer (NFT) program runs on an HP 3000 
Computer System to provide the ability to efficiently copy disc 
files • When initiated over a DSN/DS coramxinication link» the NFT 
program can copy a file to or from any other adjacent HP 3000 
computer which also provides this service. 



FEATURES OF NFT 



• You can initiate copy operations from sessions, jobs, or 
programs • 

• DSCOPY can be used to copy users' files and MPE system files, 
as well as data management files, such as KSAM/3000 files. 

• There is only one NFT command to learn -- : DSCOPY. 

e There are two intrinsics: DSCOPY and DSCOPYMSG. The 

intrinsics are callable from programs written in SPL, COBOL, 
FORTRAN, and BASIC. 

e NFT can be used in Interactive Mode to submit a series of 
copy requests. When a DSCOPY command or intrinsic initiates 
Interactive Mode, users* requests are placed in a transaction 
file whose formal designator is DSCOPYI. The default for this 
file is $STDINX. 

^ e NFT can record a history of all copy operations performed by 
^ DSCOPY requests. The history report can be printed to 
$STDLIST, as well as to a secondary file. 

• You caui initiate a copy operation from a system other than 
the system (s) where the source and target files are located. 

• NFT can efficiently copy disc files within your local HP 
3000. 

• The files referenced by a DSCOPY command (or intrinsic) may 
reside on system or private volumes. 
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Network File Transfer 

File transfers can involve one or more computers. In all ^.^^^ 

transfers, there are three distinct roles a system can play: ] 

1. The initiator is always the system where the :DSCOPY 
command originates. The initiator functions only in an 
outgoing sense. It is similar to PTOP operation, where 
the PTOP master program always issues a POPEN out across a 
DS line to cause a slave to be created and activated on a 
remote system. 

2. The producer is the source computer where the file that 
is to be copied resides. 

3» The consumer is the target computer where the new file 
will reside. 

You should remember that one system may be performing two or all 
three of these roles. 



When a DSCOPY request names a remote source, the DS line to that 
computer must be open and a remote session must exist. The same 
is also true when a remote target is specified. 



When DSCOPY is used to transfer files over two or more systems, 
the following restrictions apply: 

1. DSCOPY must be initiated only from the master side of the 
DS line. The slave (remote) side cannot be the initiator 
of a DSCOPY command. 

2. DSCOPY must not be initiated programmatically from either 
a roaster or a slave PTOP program in any direction. 



y«ft^ 
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SYNTAX 



:DSCOPY 


sfile 


, [sdsdev] 


[sdev] 

L# 1 


r TO 

• 


tfile 


t 


" tdsdevir , l~llll 
[tdev] 
Jli JJJJJ 



To submit a series of transfer requests, omit all of the source 
and target parameters to initiate Interactive Mode. NFT prompts 
you for input and, after the transfer completes, prompts you 
again. 

Terminate Interactive Mode by typing // or Control-Y* 



ji^^\ 
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PARAMETERS 



sfile (Required Parameter) Identifies the file to be copied* 
The name can be written in the following format: 

sfile [/lockword] [.groupname] [.accountname] 

If the source file is in a group. account different from 
the requestor's log-on group. account, the requestor 
must have read and lock access to the source file. 



sdsdev (Optional Parameter) The device classname, logical 

device number, or node name that was used to open the 
communications link to the remote computer where the 
source file resides. 

Default: The local system (that is, the system where 
the transfer request is submitted). 



sdev (Optional Parameter) The classname or logical device 
number of the disc where the source file resides. 

Default: DISC. 



j^^ 



tfile (Optional Parameter) Specifies the file to receive the 
data. The name can be written in the following format: 

tfile [/lockword] [.groupname] [.accoxintname] 

Default: The new file has the same filename as the 
source file. The default groupname and 
accountname are the log-on groupname and 
accountname. Security is on for the new 
file, even though the source file may have 
been released. 
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tdsdev (Optional Parameter) The device clasname or logical 

device number that was used to open the communications 
link to the remote computer where the target file will 
reside* 

Default: DSCOPY copies the sourcefile to the local 

computer and assigns the same filename as the 
sourcefile name* If the source computer is 
the local system, this default causes a file 
system error (because the file already 
exists) « 



Means the target dsdevice (the target computer) is the 
same as the source dsdevice (the source computer) . 



tdev (Optional Parameter) The device classname or logical 
device number of the disc where the new file should 
reside* 

Default: DISC 



USE 



Available 


in Session? 


YES 




in Job? 


YES 




in Break? 


NO 




Prograinmat i calljr ? 


NO* 


Breakable? 




YES 



* Call the DSCOPY intrinsic rather than use the 
COMMAND intrinsic. 
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:DSCOPY 

OPERATION 

NEVER BREAK AND ABORT DSCOPY DURING A COPY OPERATION • 

Coxitrol-T can be used to show how much of a file has been 
transferred and to cancel a currently executing copy request • If 
you enter Control- Y during a copy operation, DSCOPY prints the 
percentage of the transfer that is complete and prompts whether 
to cancel or continue the operation* 

Source and Target Files 

In a DSCOPY command, source and target files are referenced as 
defined by the systems upon which they reside. 

There is no default for a sourcefile, 

A default for a targetfile is derived from the sourcefile* The 
default consists of the first sequence of characters in the 
sourcefile name which constitutes a legal HP 3000 file name. 
For example: 

: DSCOPY SFILE.SGROUP^SNODE 

Here the source file is SFILE (in group SGROUP on a remote 
system) • The targetfile is generated in the users ' log-on group 
(on the local system) and is assigned the default name SFILE. 
The characteristics of the new file are the same as those of the 
source file. 

If a source file has a negative file code, the user requesting 
the transfer must have Account Manager (AM) , System Manager (SM) , 
or Privilege Mode (PM) capability to be allowed to copy the file. 
The log-on user on the target node must also have AM, SM, or PM 
capability. Remember that the person requesting the transfer 
(the initiator) is not necessarily the consumer (the log-on user 
at the target). After a successful copy operation, the new file 
has the same negative file code as the source file. 

VDien copying KSAM files, both the data file and its key file are 
copied. The DSCOPY user can specifically name a data file/key 
file pair by enclosing the file names in quotes and separating 
them by a comma. For example: 

: DSCOPY SFILE TO •'DATAFILE,KEYFILE" 

VOxen a user specifies a source KSAM data file and the NFT 
subsystem must generate a default key file, it uses the data 
file name and appends a K. For example: 

: DSCOPY SFILE, LINEl TO TFILE, LINE2 
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:DSCOPY 

In the case where SFILE is a KSAM data file, the new data file on ^^^^ 
the computer connected to LINE2 will be named TFILE and the '^ 

associated key file will be named TFILEK by default. 

Interactive Mode 

To execute a series of transactions, enter the :DSCOPY command 
without parameters. Now the system prompts you for input with 
the word DSCOPY and accepts your response from the file DSCOPYI 
(whose default is $STDINX) • 

The syntax required for your response follows the format already 
described for source and target parameters. 

Mote the following about Interactive Mode: 

• To continue your response on the next line, enter an /*^ 
ampersand (&) as the last non -blank character on the current 1 
line and press RETURN. A continuation prompt is printed so 

that you can continue your response. 

• To cancel a response while entering a line, use Control-Y. 

You can issue MPE comands while in Interactive Mode by 

entering a colon (:) before the command. The MPE commands 

allowed in Interactive Mode are those allowed by the COMMAND 
intrinsic. 

• To terminate Intractive Mode, enter // or Control-Y in 
response to a DSCOPY prompt. 

Event Recording 

DSCOPY produces printed output to document user input and copy ^'^ 

results. This output may be sent to a primary file and/or a ) 

secondary file, either of which may be disabled. The primary 

file is $5TDLIST and the secondary file has the formal designator 

DSCOPYL. All user requests and DSCOPY prompts are printed on 

$STDLIST and echoed on the secondary file (and on the primary, if 

not duplicative). Primary output is enabled by a DSCOPY command, 

or by the DSCOPY intrinsic with the OPT parameter set to U, 5, or 

6 (refer to the parameters of the DSCOPY intrinsic). Output for 

the secondary file, DSCOPYL, defaults to $NULL so that secondary 

output is disabled by default. It can be enabled by using a 

iFILE command to equate DSCOPYL to a file or a line printer, or 

to $STDLIST. 
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:DSCOPY 

EXAMPLES 
Local Copy 

To make a local copy of SFILE and name the new file TFILE, use 
either of the following: 

:DSCOPY SFILE TO TFILE or :DSCOPY SFILE; TFILE 

The following example copies a file named SFILE from another 
group on the local system into a file in the log-on group. The 
new file is also named SFILE. 

:DSCOPY SFILE. SGROUP 

Remote-to-Local Copy 

To copy a file from the computer connected to DS line SYSA into 
your log-on group (on the local system) , enter: 

rDSCOPY SFILE, SYSA;TFILE 

Local-to-Remote Copy 

To copy a file named SFILE (on the local system) to the computer 
attached to DS line SYSB and name the new file SFILE, enter: 

rDSCOPY SFILE TO ,SYSB 



Remote Copy 

An asterisk (*) means the target system is also the source 
system. The following example copies a file named SFILE to a new 
file named TFILE. Both files reside on the remote computer 
connected to the dsline named SYSA. 

:DSCOPY SFILE, SYSA TO TFILE,* 



Remote-to-Remote Copy 

The next example illustrates a command that copies a file from 
one remote system to another. In this case, the communications 
lines to both remote computers must be open and a remote session 
must exist on each system. 

:DSCOPY SFILE, SYSA TO TFILE, SYSB 
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NFT INTRINSICS 



Programs can use the DSCOPY intrinsic to copy disc files. 

Programs cam also print a message which corresponds to the result 
code returned by a DSCOPY intrinsic call. The DSCOPYMSG 
intrinsic is used for this purpose. 

The rules for using the intrinsics are consistent with those for 
using other MPE intrinsics. Specifically, the following rules 
apply. 

• Both intrinsics can be called from programs written in the 
SPL/3000, COBOL, FORTRAN, and BASIC languages. 

• Calling sequences for all of the languages are basically the 
same. 

• All parameters are passed by reference. 

• The intrinsics are not option variable. 

m Neither of the intrinsics are typed (returns a parameter as 
its value). 

• Neither returns a condition code (they both return a result) . 
e Split stack calls are not allowed. 

• For COBOL, data types should be defined as follows: 



./^^. 



Data Type 

Numeric 
Alphanumeric 
Numeric Array 



Data Description 

PICTURE S9(U) COMPUTATIONAL 

PICTURE X(n) or picture A(n) 

PICTURE S9(U) COMPUTATIONAL SYNCHRONIZED 
OCCURS n TIMES 



/^^ 
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DSCOPY Intrinsic 

THE DSCOPY INTRINSIC 
SPL Procedure Declaration 



PROCEDURE DSCOPY (OPT, SPEC, RESULT); 
VALUE SPEC, RESULT; 
LOGICAL OPT; 
LOGICAL POINTER SPEC, RESULT; 

OPT OPT controls the primary output (i.e. output to 

$STDLIST) and specifies the type of copy operation. 

Bits through 12 are reserved for future use and should 
be set to zero. The remaining bits can be set to 
indicate the following: 

Value Meaning 

Single transaction; primary output disabled. 

1 Multiple transactions; return after first 
unsuccessful transaction; primary output 
disabled. 

2 Multiple transactions; return after all 
transactions have been attempted or after an 
internal error occurs; primary output disabled. 

k Single transaction; primary output enabled. 

5 Multiple transactions; return after first 
unsuccessful transaction; primary output 
enabled. 

6 Multiple transactions; return after all 
transactions have been attempted or after an 
internal error occurs; primary output enabled. 



SPEC The logical array should contain ASCII text terminated 

by an 8-bit binary zero. In the single transaction case, 
the syntax required is the same as for the DSCOPY 
command parameters. 

In the multiple transaction case, the array should 
contain only a zero. Zero causes NFT to read the copy 
request from the DSCOPYI file (whose default is 
$STDIN) . 



^N, 



6-9 



DSCOPY Intrinsic 



RESULT A two -word array returned to the caller which indicates 
the outcome of the intrinsic call. 

RESULT(O) Result=0 indicates the copy operation was 
successful. Any other value represents an 
error as defined in "DSCOPY Error Messages'* 
listed in Appendix B. 

RESULT (1) Shows the number of files that were 
successfully copied. 



COBOL Calling Sequence 

CALL "DSCOPY" USING OPT, SPEC, RESULT. 

OPT Numeric data item. 

SPEC Alphanumeric data item. 

RESULT Nvimeric array of two or more data items. 



FORTRAN Calling Sequence 

CALL DSCOPY (OPT, SPEC, RESULT) ^ 

OPT INTEGER*2 variable 

SPEC CHARACTER array 

RESULT An array of two or more INTEGER*2 variables 



BASIC Calling Sequence 

CALL BDSCOPY (0, S$, R) 
Numeric variable 
S$ A string variable 
R An array of two or more numeric variables 
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DSCOPY Intrinsic 
Programmatic DSCOPY Operation 

Simultaneous DSCOPY requests cannot be issued from two 
processes in the same session. 

The only valid values for the OPT parameter are: 0» 1, 2, k^ 5, 
or 6. 

The ASCII text passed by the SPEC parameter must be terminated by 
a binary zero. 

The values passed in the parameters are verified as being in 
bounds and valid. 

The system creates the NFT process and passes the contents of OPT 
and SPEC to it. 

The specified files are copied by the NFT process. 

The intrinsic returns the result to the user. 

After process ing, OPT and SPEC remain unchanged except that any 
ASCII lower case characters in SPEC may have been shifted to 
upper case. 

After processing, the first word of the RESULT contains a number 
which indicates the outcome of the DSCOPT request. A zero value 
indicates a successful transfer operation; the meaning of any 
other value is given under "DSCOPY Error Messages" in Appendix B. 
The second word contains the number of files successfully copied. 
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DSCOPYMSG Intrinsic 

THE DSCOPYMSG INTRINSIC 



SPL Procedure Declaration 



PROCEDURE DSCOPYMSG (RESULT, FNUM, R); 

VALUE FNUM; 

LOGICAL ARRAY RESULT; 

INTEGER FNUM, R; 



RESULT The two-word result returned by the DSCOPY intrinsic. 
- DSCOPY was successful. 

n = An error occurred. Refer to the Error Messages in 
Appendix B for the meaning. 



FNUM When FNUM^O, the message associated with RESULT is 
printed on $STDLIST. 

When FNUM contains a file number returned by an FOPEN 
call, the message associated with RESULT is written to 
the file. 



/^^ 
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Result returned by this DSCOPYMSG call. 
= Successful call 

n = Unsuccessful call. Refer to the Error Messages in 
Appendix B. 



COBOL Calling Sequence 

CALL "DSCOPYMSG" USING RESULT, FNUM, R. 
RESULT An array of two or more data items, 
FNUM A numeric data item. 
R A numeric data item. 



'^ 
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FORTRAN Calling Sequence 

CALL DSCOPYMSG (RESULT, FNUM, R) 

RESULT An array of two or more INTEGER* 2 variables. 

FNUM INTEGER*2 variable 

R IN!nEGER*2 variable 

BASIC Calling Sequence 

Call BDSCOPYMSG (R, F, RO) 

R An array of two or more numeric variables 
F An integer vsiriable 
RO An integer variable 

EXAMPLES 



A very simple example of a programmatic DSCOPY request is shown 
coded in the COBOL » FORTRAN ^ and BASIC languages. 

The example copies a file (NFTTESTS) to a new file (TEMPI). The 
source file resides on the local machine, and the new file will 
be created on a remote machine connected to line "HDS". 
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DSCOPY COBOL Example 

1 ICONTROL CODE 

1.1 $TITLE " DSCOPY INTRINSIC TEST" 

1.2 IDENTIFICATION DIVISION. 

1 . 3 PROCSRAM- ID . DSCOPYOO . 
l.U AUTHOR. JIM BRANDT. 

1.5 DATE-WRITTEN. APRIL I98O. 

1.6 DATE-COMPILED. 

1.7 REMARKS. 

1.8 THIS raOCSRAM DOES A SIMPLE INTRINSIC CALL TO DSCOPY. 

1.9 ENVIRONMENT DIVISION. 

2 CONFIGURATION SECTION. 

2.1 SOURCE -COMPUTER. HP3000 

2.2 OBJECT-CC»!PUTER. HP3000 

2.3 DATA DIVISION. 
2.U WORKING-STORAGE SECTION. 

2.5 01 OPT PIC S9(U) C<MP VALUE 0. 

2.6 01 STRINGl. 

2.7 02 ASCIIPART PIC X(2l») VALUE "NFTESTS TO TEMPl.HDS". 

2.8 02 TERMINATOR PIC S9(U) COMP VALUE 0. 

2.9 01 RESULTl. 

3 02 RESULT2 PIC S9(U) COMP OCCURS 2 TIMES. 

3.1 PROCEDURE DIVISION. 

3.2 BEGINLABEL. 

3.3 CALL "DSCOPY" USING OPT, STRINGl, RESULTl. 

3.U STOP RUN. v^ 



DSCOPY FORTRAN Example 

25 $CONTROL MAP, LIST, CODE, CROSSREF, LOCATION, STAT 

26 PROGRAM DSCOPY 

27 CHARACTER*UO STRINGl 

28 INTEGER*2 FNUM ^ 

29 INTEGER*2 OPT ' 

30 INTEGER ARRAY IRESULT(U} 

31 C 

32 DATA STRINGl/" NFTTEST TO TEMPI, HDS "/ 

33 C 

3U C THIS PROGRAM DOES A SIMPLE DSCOPY INTRINSIC REQUEST 

35 C 

36 OPT=0 

37 FNUM=0 

38 CALL DSCOPY (OPT, STRINGl, IRESULT) 

39 IF (IRESULT .GT. 0) CALL DSCOPYMSG( IRESULT, FNUM) 
UO STOP 

Ul END 



^*^% 
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DSCOPY BASIC Example 

10 REM THIS WILL DO A SIMPLE DSCOPY REQUEST 

20 DIM A$[30]«R[U] 

30 0=R2=Z=0 

kO MAT R=ZER 

50 A$=" NFTTESTS TO TEMPI, HDS " 

60 PRINT A$ 

70 CALL BDSCOPY(0,A$,R[*]) 

80 IF R[l] <>0 THEN PRINT " ERROR IN DSCOPY. ERR0R= ",R[1] 

90 IF R[lj <>0 THEN CALL BDSCOPYMSG(R[*] »Z,R2) 

100 STOP 

110 END 
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DS APPLICATIONS 



SECTION 



VII 



DSN/DS is particularly useful in applications that involve trans- 
action processing and that are geographically or functionally 
dispersed. Any local-system command can be executed remotely 
through a simple extension to that command. Many operating 
system intrinsics are also extended in a similar fashion. No 
knowledge of the communication protocol or physical link being 
used is required of the terminal user or application programmer. 
Every application -level capability operates transparently across 
each connection-level alternative. 



DSN/DS on the HP 3000 provides facilities for point-to-point 
connection between processors. These connections can be made on 
a variety of tjrpes of communication lines, including switched 
(dial-up) , leased, or hardwired, and they can also be mixed 
throughout the network. Applications can easily obtain access to 
systems more than one "hop" away, through multiple : REMOTE HELLO 
log-ons. In addition, HP 3000 computers caoi connect to X.25 
packet -switched and X.21 circuit -switched networks and coromiini- 
cate across those networks with HP 1000 or other HP 3000 
computers. In fact, DSN/DS can maintain concurrent connections 
to multiple remote systems, and/or multiple connections to the 
same remote system, over a single physical link to the X.25 net- 
work. 



DSN/DS requires users to pass all of the security checks imposed 
by MPE (such as passwords) when logging on to a remote system. 
DSN/DS also provides additional security features applicable only 
to a network environment. For example, the operator can restrict 
incoming or outgoing access to the communications link. And in- 
coming calls from an X.25 network are accepted only if the remote 
host is already in the local system's network data base. 
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DSN/DS offers the tools to facilitate the sharing of resources ^.^^^ 

within a network. Examples of such resources are programs, data J 

structures » or physical hardware elements of the network. You 
can access these resources in any of several modes: 

e Remote command execution allows you to direct commands to 
any CPU in the network. 

e Remote File Access (RFA) permits the application of 

processing power to files and devices remote from the CPU. 
RFA also provides the means for extending Interprocess 
Communications (IPC) across a DS link. 

e Program-to-program (PTOP) communication permits direct 
communications between master and slave programs , each 
resident in its own CPU within the network. 

• Remote Data Base Access (RDBA) gives the capability for 
direct and indirect access of data bases on any HP 3000 
computer in the network. Combining the distributed 
processing capability of DSN/DS with the use of data 
management subsystems such as V/3000, KSAM/3000, and 
IMAGE/3000 makes possible the sharing of data. 

• Network File Transfer (NFT) is a more efficient mechanism than 
FCOPY for transferring disc files across a communications 
link. 

The chief advantages of Program -to -Program (PTOP) communication 
are coprocessing capabilities and control of data transmission 
blocking. Coprocessing master-slave programs execute in multiple 
systems. Program- to -Program commxmication allows decisionmaking 
to be distributed within the master-slave relationship. The 
exchange of data and control information between the executing 
programs can be used to alter program flow to adjust to current 
conditions in the network. Remote command execution and remote 
file/device access allow one program executing in one CPU to 
utilize data and/or devices anywhere in the network. All 
decisionmaking* is embodied in this one program. Coprocessing 
capabilities assume importance in networks where synchronization 
of modifications to related data structures is important. 

Blocking control can be utilized in such a manner as to decrease 
the niunber of transmissions to move a specific amount of data. 
Since transmission time on a high-speed link is a negligible 
factor in commmiications performance, the required number of 
transmissions is the key to performance. Reducing the nximber of 
transmissions correspondingly reduces the number of line turn- 
arounds. This may become a significant performsu:ice factor in 
half -duplex networks or satellite commvinication links where prop- 
agation delay affects response time. 
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TRANSMISSIONS BETWEEN SYSTEMS 



Underlying all modes of utilizing DSN/DS is the transmission of 
data from one system to another. Now compare the building of 
these transmission units for remote file access and for PTOP. 

DSN/DS is supported on three controllers: the Intelligent Network 
Processor (INP), the Hardwired Serial Interface (HSI), and the 
Synchronous Single-Line Controller (SSLC). To configure any of 
these devices into the system, you must specify a buffer length. 
The buffer length value that you specify represents the maximum 
number of words to be transmitted between systems in one 
transmission and it is the system's default buffer size. When 
you activate DSN/DS with a :DSLINE command » a LINEBUF parameter 
may be specified to override the configured buffer size. Only 
the first user to activate the line may use LINEBUF to alter the 
data commimication buffer size. This buffer size may not be 
respecified until all concurrent DSN/DS users have closed their 
links. In this way, the pertinent buffer limiting factors for 
inter-CPU trainsmissions are set. 

How is LINEBUF utilized in accessing remote files and remote 
peripheral devices? The basic unit for file system operations is 
the record (or block of records). In remote file access and 
remote command execution, file system blocking limits the trans- 
mission \mit to a single record or sequential multiple records. 
File system's FREAD is satisfied by moving a logical record from 
a file to the user's buffer. An FREAD on a file open with multi- 
record access is satisfied by a byte count which can be specified 
to be blocksize. Thus, an FREAD on a remote file will pack 
LINEBUF with a record or a specified byte count of sequential 
records. Contrast this record-orientation to the array- 
orientation of PTOP communications. PTOP's PREAD is satisfied by 
the transmission between programs of the contents of LINEBUF. 
The PTOP programmer must construct the buffer by packing it with 
array (s), record(s), or fields of records. The records in one 
transmission need not even come from the same file. 

In addition to transmitting specified data, DSN/DS attaches a 
header of varying lengths. The header always contains eight 
words transmitted in a fixed format and can contain additional 
words in an appendage area. For remote command execution and 
remote file euid peripheral device access, the data field is 
usually preceded by a header of ik words. Some intrinsics, such 
as FREAD ( mult ire cord ) , require a longer header to convey all 
parameter information. The header for PTOP communications 
includes the 20-word tag field in the appendage; thus the typical 
PTOP header is 3^ words long. The ideal LINEBUF size will allow 
the user's data field plus DSN/DS header information to fit into 
LINEBUF. 
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To illustrate: Assume that you want to read six 80-byte records 
from a remote file. Specify a LINEBUF of 300 words. 

a. If the remote file is thus defined: REC=-80,1,F» then Remote 
File Access must retrieve a block of one record from the 
disc, FREAD one record, and transmit one record. The com- 
plete data transfer requires six disc accesses, six FREADs, 
and six data transmissions. 

b. If the remote file is thus defined: REC=-80,6,F, then Remote 
File Access must access the disc to retrieve a block of six 
records, satisfy an FREAD with one record, and transmit one 
record. The complete transfer requires one disc access, six 
FREADs, and six data treinsmissions. 

c. If the remote file is thus defined: REC=-80,6,F, and opened 
with the NOBUF and multirecord aoption, then Remote File 
Access must access the disc to retrieve a block of six rec- 
ords, satisfy an FREAD of U80 bytes with six records, and 
transmit the six records. The complete data transfer re- 
quires one disc access, one FREAD, and one data transmission. 

d. In PTOP, the master program can issue a PREAD. The slave 
program can pack the buffer with all six records, utilizing 
any of the above three methods. Note that a LINEBUF of 300 
words is ample to permit transmission of U80 bytes (2U0 
words) of data plus 3k words of DSN/DS header information in 
one transmission. A LINEBUF of 256 words requires two trans- 
missions. 



COORDINATING MASTER AND SLAVE PROGRAMS 



PTOP communication programming requires synchronizing two 
separate programs at specific points in time. For this reason, 
it is often helpful to block diagram the transmissions and their 
contents on a simulated time line. 

Where the PTOP programmer wants to loop on certain PTOP 
operations, the loop's terminating condition must, of course, 
be defined. The master program has direct control over the 
interprogram communications and can terminate a loop under 
conditions defined locally. More difficult are the situations 
when the slave must communicate to the master that the 
terminating condition has been met. To do this, the slave might 
send a REJECT response* A REJECT does not allow transmission 
of data, and so requires a terminating exchange of transmissions 
after all data has been transmitted. 
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Another method is to utilize the 20-word itag field (the ITAG 
parameter) of the PTOP intrinsics. This field is not accessible 
by the slave unless designated as a parameter in the correspond- 
ing master's PTOP operation. For example: 



Master Program Slave Program 

Example A. PREAD (dsnum, target ,t count) ; GET(itag) ; 

Example B. PREAD ( dsnum , target , t count , itag ) ; GET ( itag ) ; 



In example A» PREAD doesn't utilize the itag field. The slave 
program can't access itag on this transaction. The second PREAD 
(Example B) might not even initialize the itag array, but the 
array has been specified as a parameter. The slave program can 
now return control information to the master via this field. The 
master program logic can inspect itag and take corresponding 
action. 

A PCONTROL from the master will also cause an exchange of itag 
fields and may be used for passing control information. This 
intrinsic will not pass a data field, however. 

The control information passed between programs may terminate a 
loop, may branch to another part of the program, may transmit an 
index to be used in a CASE statement, or may serve any other 
purpose the programmer desires. 

It is important to bear in mind the accessibility of 
transmitted data. When the master program PWRITEs, the slave 
program ceuinot process the received data until the ACCEPT 
intrinsic has moved the data into the slave process stack. 
The slave program can, however, examine the itag array before 
doing the ACCEPT or REJECT. After examining the itag, the slave 
can then alter the itag array. The ACCEPT or REJECT will 
transmit the slave's itag to the master. Slave local processing 
can then proceed. 



DEBUGGING 



Where the amount of local processing in a PTOP application 
is significant, it may be helpful to debug the master and slave 
programs as local programs. MOVEs on dummy arrays or FREADs on 
dummy files can be substituted for communication operations to 
simplify debugging of the local processing. 
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When the time arrives to run the programs in master- slave 
fashion, a :RUN PROG;DEBUG is sufficient to invoke the Dehug 
Utility for the master. This will not, however, allow the 
programmer to break-point in the slave program or to examine the 
slave process stack. To facilitate debugging slave programming, 
the first executable statement of the slave program should be the 
DEBUG intrinsic. 



LINE BUFFERS/CONTINUATION BUFFERS 

DSN/DS is designed to send across the line, in a single transfer 

operation, the amount of data configured as the PREFERRED BUFFER 

SIZE for the line controller (INP, SSLC, or HSI). The first ^ 

person to use a DS line can override the configured line buffer ^ 

size by specifying a different value with the LINBUF parameter of 

a :DSLINE command. 

When a user specifies LINBUF=xxxx, the xxxx value tells the 

Communication Software (CS/3000) the maximum amount of data 

DSN/DS will ever send across the line in a single request. For 

example, if you say LINBUF=107U, you are saying the largest ^^ 

buffer DSN/DS can pass to the Communication Software is I07U ^*^ 

words . 

The IO7U words will always consist of both user data and DSN/DS 
fixed header and variable -length appendage characters* These 
additional characters (approximately 20 to ^0 words) give to and 
from information, intrinsic names, etc., and vary for RFA and 
PTOP operations. 

For RFA, the DSN/DS header and appendage usually adds about 20 ""^ 

words to the data; for PTOP, the header and appendage also 
includes the 20-word tag field, for a total of approximately kO 
words. The ideal LINBUF size should be able to accommodate the 
user's data plus these DSN/DS overhead characters. 

When a DSN/DS user requests the transfer of more data in a single 
operation than the line buffer can accomodate, the Communication 
Software automatically fills the line buffer, makes the transfer, 
refills, and transfers again -- until all of the user's data has 
been sent. Vfhen a user's single request causes CS/3OOO to make 
several transfer operations, the additional buffers of data are 
known as "continuation buffers". As stated before, the ideal 
line buffer should be large enough to eliminate the need for 
continuation buffers. 
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COMPRESSION 



Compression of data on the communications link may be specified 
in order to achieve higher throughput. 

The COMPRESSION capability can be specified at generation time by 
use of SUBTYPE=1 while configuring lODSO or lODSX (refer to 
Appendix A). This configured subtype sets the default for the 
line* 

A compression parameter may be specified while executing the 
:DSCONTROL console command. A console operator uses the 
parameter to override a line default or to reset to the 
configured state. 

A compression parameter may also be specified while executing a 
:DSLINE command in a session or job. Use of the DSLINE parameter 
allows individual users to control whether or not their data will 
be compressed. 

The compression technique compresses any occurance of three or 
more consecutive characters. The compression takes place in the 
data only^ not in the fixed part or the appendage of the request 
or reply header. 

Compression generally increases throughput by reducing redundancy 
in the data, which results in a reduction in the nxxmber of char- 
acters being transmitted over the communications link. 

In some cases, however, compression could actually result in an 
increase in the nxamber of characters to be transmitted. For this 
reason, DSN/DS examines each case when compression is specified. 
If a situation is found where compression would be detrimental to 
performance, DSN/DS sends the data uncompressed. 

Compression is most helpful in applications using line speeds up 
to 56 K bps. However, compression is generally not helpful nor 
desirable in applications that use the HSI at high data rates. 

Doing compression and decompression increases the system overhead 
at both ends of the link. The decision on whether to use com- 
pression depends on the communications link data rate, system 
load, and the amount of redundancy in the data being transmitted. 
Often, a test of relative throughput with normal system load and 
"typical" data will provide an indication of the benefits of 
using compression. 

The amount of redundancy in data or files may vary significantly. 
Source or listing files may compress by as much as 75 percent. 
But a more tsrpical random assortment of HP 3000 files may reduce 
by an amount closer to 25 percent. Obviously, the actual reduc- 
tion will vary from application to application. Comparative 
tests with and without compression will indicate the benefits. 
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The DSN/DS initialization procedures allow compression only if ^^^ 

both systems are capable of performing compression* Compression ^ 

is handled on an individual basis, so that on a non-exclusive 
line, some users may compress while others use NOCOMP. 



Formats for Inserted Compression Characters 



Octal Value 


Meaning 


XX nnn nnn 


XX = compression type 




00 = uncompressed character 




string 




10 = repeated blanks 




11 = repeated non -blank 




character (next byte is 




the character) 



nnn nnn = octal character count 
1 to 77. 

Examples : 

036 36 (octal) non -compressed characters 

217 17 (octal) blank characters 

323.052 23 (octal) compressed ** characters 



PERFORMANCE 

The performance achieved while using the DSN/DS link may vary 
widely, and it depends on many factors* 

Computer System Dependent 

The activity mix on the respective HP 3000 will affect perfor- 
mance. It depends upon the character of the simultaneous activi- 
ty: such as the number of jobs» nximber of CPU-bound jobs and 
their relative priority, contention for disc, memory size and 
amount of swapping, quantxun size, etc. 

Communication Linlcs 

The choice of the communications link will provide an upper limit ^^^ 

to the performance. Generally, a full-duplex line will outper- 
form a half -duplex line by reducing line turnaround delays. A 
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half-duplex line with a smaller request-to-send/clear-to-send 
delay will be faster (such as a 208B at 30 milliseconds versus a 
208B at 130 milliseconds). 

Line quality can result in wide variations in performance at 
times when line errors are high. A leased line is generally 
better and more predictable than a dial-up line. Some telephone 
offices provide cleaner lines depending on the age and nature of 
their switching gear. 

Applications 

For a given amount of data, the buffer size selected will affect 
performance • The smaller the number of requests required to 
transmit a given quantity of data, the higher the throughput. 
This also includes continuation requests. The data may be packed 
into larger buffers while using PTOP applications. The data may 
also be blocked into larger records for RFA applications. (RFA 
and FCOPY handle one record at a time, even though the file may 
use blocking) . 

As described earlier, use an appropriate line buffer size. Use a 
line buffer large enough to contain the full record or buffer, 
plus the DSN/DS fixed blocks and appendage header words. (The 
"rule-of-th\imb** is 50 words larger than the data size.) 

For applications to be run on dial-up lines, the line errors 
normally suggest a reasonable maximum of 102U words. Analysis of 
:SHOWCOM xx ;ERRORS output and trace listings for error rates 
will allow modification of this recommendation for "typical" 
conditions. (This suggested maximum value of 102U could be 
either increased or decreased when an SSLC is being used; but the 
value could only be decreased when the communications interface 
is an INP, since the maximum buffer size for the INP is 102U 
words • ) 

PTOP applications allow both the master and slave programs to do 
a larger share of data searching, qualification, and manipulation 
at each local computer, thus reducing the quantity of data which 
must be sent across the line. 



Remote Listing 

Vttiere data must be sent to a remote device (such as a line print- 
er or a magnetic tape) it may be possible to send the program 
which generates the data to the remote computer for execution. 
For example, since a compiler listing can be quite large, it 
might be more efficient to transmit the source across the line 
and do a remote compilation and remote list, rather than doing a 
remote list for a local compilation. 
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MULTIPLE REMOTE ACCESS 



While presenting the basic concepts of DSN/DS in the tutorial 
sections of this manual, the examples were intentionally limited 
to simple networks. From those somewhat simplistic 
illustrations » it might appear as though the only way your local 
computer can talk to more than one other computer is through 
additional parallel communication lines from your local system to 
the additional remote systems. Actually, it is possible to 
commimicate with other remote computers in the network that have 
no direct connection with your local computer. This 
communication is made possible by going through one remote 
computer (to which you do have a direct communication line) to 
reach another remote computer to which the first remote computer 
is connected. To reach a second remote system through a first 
remote system, a multiple REMOTE command is used. The sjmtax is 
as follows: 



: REMOTE [xxx] [REMOTE [xxx]] 



[command] 



In this way, the local user can initiate a session sequentially 
on each remote system. Refer to figure 7-1* 



SYSTEM 
A 



iREMOTE LISTF 



, lists these 
files to 
System A 



SYSTEM 
D 



: REMOTE REMOTE LISTF , 



:REMOTE REMOTE REMOTE LISTF 



. lists these 
files to 
System A 



, lists these 
files to 
System A 



Figure 7-1* Multiple Remote Accessing Example 
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Figure 7-1 shows how your local system (System A) can obtain a 
list of the files in the first remote system (System B) by 
issuing the command: 

: REMOTE LISTF 



To obtain a similar list of files from System C in this kind of 
network (where the communications link is through an intermediate 
remote computer), use the command: 

: REMOTE REMOTE LISTF 



Likewise, you can route your request through to System D by 
expanding the command to: 

: REMOTE REMOTE REMOTE LISTF 



Using this compound command accomplishes the same result as if 
you had issued the following series of separate commands: 

; REMOTE 
# REMOTE 
#REMOTE 
#LISTF 



There is an important difference in the way of returning to your 
local system, however. When you reach System D (figure 7-1) by 
entering the compoxmd command 

; REMOTE REMOTE REMOTE 
# 

the # prompt is coming from the Command Interpreter (CI) on 
System D. If you now type a colon (:) 

#: 



you are being switched back to your local CI (System A). But if 
you were to use the alternative method of reaching System D with 
a series of separate commands 

: REMOTE 
# REMOTE 
# REMOTE 
# 
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and then you typed a colon as before, you would be switched to ^.st^ 

System C. To get back to your local system (System A), you must ^ 

return a step at a time (just as you went out to System D a step 
at a time) as follows: 

; REMOTE 

# REMOTE 

# REMOTE 

#1 

#1 

#: 
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INTERPROCESS COMMUNICATIONS 



Interprocess Communications (IPC) is a capability of the MPE 
operating system that is very beneficial in the DSN/DS environ- 
ment. For some applications, IPC may be easier to implement than 
Program -to -Program Communications (PTOP) and may provide other 
advantages as well. A basic description of the use of IPC and 
the changes made to the file system is included in the MPE 
Intrinsics Reference Manual. 



j^0^. 



A simple example of the use of IPC for communication between two 
remote sessions is presented in figure 7-2. User Bill 
establishes a local session on Node A and a remote session on 
Node B. His application, called BILLPROG, opens a local MSGFILE 
as a reader and a remote MSGFILE as a writer. Then, user 
Jack establishes a local session on Node B and a remote session 
on Node A. Jack's application, called JACKPROG, opens a local 
MSGFILE as a reader and a remote MSGFILE as a writer. Now these 
two unrelated processes can communicate with each other through 
the IPC capability. 



NODE A 



NODES 



c 



BILLPROG 



J^ FREAD 



MSGFILE 




FWRITE 



/ 



FWRITE 



MSGFILE 
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Figure 7-2. Two-node IPC Commtmlcation 
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DS Applications 



If PTOP had been used in the example in figure 7-2 » a PTOP master 
program would need to be executing in one node and a slave pro- 
gram would have been initiated by the master in the other node* 
The master-slave programs would also require coordination because 
of their relationship. 



The advantage of IPC becomes more dramatic when two or more pro- 
cesses desire to communicate with each other » or when the network 
is more complex than two nodes. Figure 7-3 shows a network con- 
sisting of three nodes and a solution that seems very useful in 
the general DSM/DS applications environment. 
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Figure 7-3. Three-node IPC Communication 
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DS Applications 



In figure 7-3 » a general application program called Message 
Switching Procedure (MSP) is written and executed on each node. 
The MSP performs the following functions: 

• Opens a local message file as a reader 

• Opens any local applications message files as a writer 

• Opens all DS lines to adjacent nodes 

• Establishes a remote session on each of these nodes 

• Opens a message file on each adjacent node as a writer to be 
used for communication with each MSP. 

The MSP handles all outgoing requests by forwarding them to the 
MSP programs on adjacent nodes. MSP also handles all incoming 
requests by routing them to a local application program or by 
passing them on to the next node in the network. 

If the network is complex and it is desirable to shift the 
responsibility for routing from the user to the MSP, a solution 
might include addressing within the user's data buffer and the 
use of a directory file in conjunction with the MSP. The MSP 
would then use the directory file to determine to what node it 
should forward the message. A more advanced directory file could 
provide alternate routes in case of downed lines. If alternate 
routes were not available, the unserviceable requests could be 
stored in a disc file and then be rewritten to the MSP*s MSGFILE 
when the downed lines are restored. 

In a simple network, it may not be desirable to design an MSP; 
but it is still possible that using IPC may be more advantageous 
than using PTOP. In this case, each user application could set 
up one or more remote sessions on the appropriate node(s) and 
commiinicate with other processes using the normal file intrinsics 
(FOPEN, FREAD, FWRITE, and FCLOSE) and message files. Also, by 
using the :FILE command, it can be transparent to the user or to 
the application program that the MSGFILE is located on a remote 
node. 

The advantage of using an MSP is that several users on a system 
can communicate with a number of remote processes, but only one 
remote session is required per node. Since fewer remote sessions 
are necessary, the amoimt of memory required is decreased. 

The major advantage of IPC versus PTOP is that there is no 
limitation to the number of local or remote processes with which 
a single process can communicate. The processes are fully 
bilateral with IPC making it easier to implement and expand the 
application for more complex networks. Also, activities such as 
development, testing, and debugging can all be done on one node, 
and then the resulting application can be distributed. 
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CONFIGURATION DIALOGUE 



APPENDIX 



DSN/DS operation requires the installation and configuration of 
one comm\inications interface for each line to a remote computer; 
or, in the case of DS/X.25* one communications interface is 
required for each physical link to a Public Data Network (PDN). 



This appendix explains how to configure the following: 

• Intelligent Network Processor (INP) 

• Synchronous Single -Line Controller (SSLC) 

• Hardwired Serial Interface (HSI) 

• DS Line Monitor (communications driver lODSO or lODSX) 

• DS Virtual Terminals (lODSTRMO, lODSTRMX, or lOPADO) -- one 
for each session that will be allowed on your system from a 
remote system or from a Packet Assembler/Disassembler (PAD). 



The same communications interface (INP, SSLC, or HSI) can be used 
by another HP 3000 data communications subsystem (such as 
DSN/MRJE) when it is not being used by DSN/DS* In such a case, 
the communications interface is configured once for each sub- 
system (each time with a unique logical device number, but always 
with the same DRT number). Keep in mind that the following 
dialogue applies only when the interface is used for DSN/DS 
activity, and that a response that is optional for DSN/DS may not 
be optional for one of the other subsystems. Configuration 
guidelines pertaining to the other subsystems are given in the 
reference manual for each subsystem. Configuration summary 
tables for each of the communications interface types are 
included in the Commiinications Handbook. 



For any data communications subsystem to function, CS/3000 
modules must be present on the system. It is presumed in this 
configuration description that the Accoxint Systems Engineer (SE) 
has already installed CS/3000. 



If you are making any other changes to the MPE I/O system, 
refer to the System Manager / System Supervisor Reference 
Manual. 
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Configuration Dialogue 



Configuration is accomplished through an interactive dialogue 
between you and the computer system. As the questions or 
prompts appear on your console, enter the appropriate replies 
through the console keyboard for your desired system 
configuration . 



NOTE 



In all responses, 7 or N can be used for 
YES and MO. A carriage return is equivalent 
to NO. 



Prior to entering the dialogue, log onto the system and input 
at least a file reference to a magnetic tape, as follows: 

:FILE name;DEV=TAPE 
:SYSDIJMP*name 



The dialogue commences as follows: 



Step Dialogue 

No. 



1 ANY CHANGES? YES 

2 SYSTEM ID = HP 32002 v.uu.ff? return 

3 MEMORY SIZE= xxx? return 

3.1 I/O CONFIGURATION CHANGES? YES 

3.2 LIST I/O DEVICES? YES 

All I/O devices currently configured on the system are 
listed with the following column headings: 

LOG DEV Logical device number. 

DRT # Hardware device address (Device 
Reference Table number) configured 
on the interface board. 

UNIT # Hardware unit number of device on 
its controller. 

CHAN Channel number of device on its 

controller. 
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jm^ 



Step 
No. 



r 



j^^. 
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3.3 



^^N. 



Dialogue 



TYPE 
SUBTYPE 
TERM TYPE 
TERM SPEED 
REC WIDTH 
OUTPUT DEV 
MODE 



DRIVER NAME 



Device type. 

Device subtype. 

Terminal type. 

Terminal speed. 

Record width in decimal words. 

Device class name or device Idn. 

J = Accept jobs 

A = Accept data 

I = Interactive device 

D = Duplicative device 

S = Spooled device 

Driver name . 



DEVICE CLASSES Class name assigned to the inter- 
face. 



NOTE 



The prompt in Step 3.3» below, appears 
only if a communications subsystem (CS) 
device was previously configured into 
the system. 



LIST CS DEVICES? YES 

A list of all CS devices currently assigned to the 
system is printed with the following column 
headings : 



uua 
PM 


ijUgXWClX UtSV±fJ« UUillUVX . 

Port Mask. (Not used by 
SSLC.) 


INP 


and 


PRT 


Protocol. 






LCL MOD 


Local mode. 






TC 


Transmission code. 







A-3 



Configuration Dialogue 



Step 
No. 



RCV TMOUT 
CON TMOUT 
MODE 



TRANSMIT 
SPEED 

TM 

BUFFER SIZE 

DC 



Dialogue 

Receive timeout (in seconds). 
Connect timeout (in seconds). 

= Dial out. 

1 = Manual answer. 

A = Automatic answer. 

D = Dual speed. 

H = Half speed. 

C = Speed changeable. 

Transmission speed (characters per 
second) . 

Transmission mode. 

Default buffer capacity, in words. 

Driver changeable or not changeable. 



DRIVER OPTION Driver options. 

If you have a switched device, such as those that 
are connected through a dial-up telephone line, then 
you receive the following additional information: 



LDN 

CTRL LEN 

PHONE NUMBER 
LIST 



LOCAL ID 
SEQUENCE 

REMOTE ID 
SEQUENCE 



INP or SSLC logical device number. 

Not currently implemented. 

A single telephone number — the 
default for the data communications 
line. 

The default identification of the 
local computer. 

The default identification of the 
remote computer. 



3.k HIGHEST DRT=xx? 

In the output, xx is a value denoting the present 
highest DRT entry number that can be assigned to a 
device . 

To change xx, enter the new value desired. If the 
highest -numbered device in the configuration is a 
device that uses more than one DRT entry (such as a 
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Configuration Dialogue 



r 



^K. 



Step Dialogue 

No. 



terminal controller with one or two data set con- 
trollers), be sure to enter the highest of the DRT 
numbers . 

To maintain the current xx, enter a carriage return. 



3.5 LOGICAL DEVICE #? 

To specify a device to be added or removed, enter 
the logical device number of that device. An HSI 
has four ports and thus can be conf igiired up to four 
times with a unique logical device number for each 
port. In addition, a communications driver (lODSO) 
with a unique logical device number must be config- 
ured for each HSI port configured. 

This prompt is repeated later in the configuration 
dialogue, so that you can return to this point to 
configure more than one device. 



iji^'V 



3.6 DRT #? 



^^\ 



To add a device, enter its DRT entry number. For a 
communications driver and a virtual terminal, you 
must assign the logical device number of the asso- 
ciated communications interface (INP, SSLC, or the 
HSI port), preceded by a number sign (#)• 

Virtual terminals need to be configured for only one 
port of any HSI (back referenced to only one logical 
device number for the HSI). The terminals will be 
djmamically allocated to the proper port when a user 
opens it. 

To remove a device and return to Step 3*3$ enter 
zero. 



3.7 UNIT #? 



Enter zero for an INP, an SSLC, an HSI, the DSN/DS 
Communications Driver (lODSO or lODSX), or Virtual 
Terminals (lODSTRMO, lODSTRMX, or lOPADO). 



3-8 SOFTWARE CHANNEL #? 
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Configuration Dialogue 



Step Dialogue 

No. 



3.9 TYPE? 



Enter the device type, where 

16 = Virtual Terminal or PAD Terminal 

17 = Intelligent Network Processor (INP) 

18 = Synchronous Single-Line Controller (SSLC) 

19 = Hardwired Serial Interface (HSI) 
Ul = DSN/DS Communications Driver 



NOTE 



When configuring Device Type I6, consider 

the maximum number of terminals supported 

by your system. Each virtual terminal 

conf igxired is added to the total number ^"^ 

of terminals already on the system. 



3*10 SUBTYPE? 



Communications Interface: 
For an INP, enter 0, 1, or 3 

For an SSLC, enter or 1 ^^^^^^ 

For an HSI, enter 3» where ^ 

= switched line with modem 

1 = nonswitched line with modem 

3 = hardwired line, synchronous transmission 

Communications Driver: 

For lODSO or lODSX, enter or 1, where 

== no data compression 

1 = data compression 

Virtual Teiminal or PAD Terminal: 

For lODSTRMO, lODSTRMX, or lOPADO, always enter 0. 



NOTE 



If you are configuring a terminal (Type 
16), the dialogue continues to Step 
3.11. If you are configuring an HSI 
(Type 19), the dialogue skips to Step 
3.13. If you are configuring an SSLC 
(Type 18), the dialogue skips to Step 
3.IU. If you are configuring an INP 
(Type 17) » the dialogue skips to Step 
3.17. For all other device types, the 
dialogue skips to Step 3-**0. 
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Step Dialogue 

No. 



3-11 TERM TYPE? 

This question is asked only if Type is l6. Term Type 
is always zero for DSN/DS Virtual Terminals or PAD 
Terminals • 

3.12 SPEED IN CHARACTERS PER SECOND? 

This question is asked only if device Tjrpe is l6» 
then the dialogue skips to Step 3«^0. 



3.13 PORTMASK? 

This question is asked only if device Type is 19 
(HSI ) • The values allowable are shown below and must 
be entered in decimal. This forms a mask indicating 
which HSI channel will be used. Only one of the four 
channels may be designated for each unique logical 
device number. 

Enter 8 for HSI cable connector port 0. 

Enter U for HSI cable connector port 1. 

Enter 2 for HSI cable connector port 2. 

Enter 1 for HSI cable connector port 3* 

Since only one port on the HSI PCA can be opened at 
a time, only one block of virtual terminals (entered 
later in this configuration) are needed for that HSI 
PCA. This same block is automatically reallocated to 
each new port opened. One block of virtual terminals 
serves all ports. 

3.11* PROTOCOL? 1 

This response defines Binary Synchronous Communi- 
cations . 

3.15 LOCAL MODE? 

For an HSI, enter 1. 

For an SSLC, enter 1 or 2 where 

1 = Local is a primary contention station 

2 = Local is a secondary contention station 
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Step Dialogue 

No. 



To resolve the contention problem in point-to-point 
operations, each station is assigned a priority 
(primary or secondary) • Because the secondary sta- 
tion can gain control of the line for a transmission 
only when the line is left free by the primary sta- 
tion, the SSLC is usually configured as a primary 
station. 

Local mode determines the amount of time a local 
station will wait in response to a line bid; primary 
station timeout is two seconds and secondary is 
three seconds. If a response from the remote system 
is not received within the allowed time (two seconds 
for primary or three seconds for secondary) , the 
line bid is re -transmitted until the number of 
retries permitted by the communications software is 
exhausted. 



3.16 TRANSMISSION CODE? 

For an HSI, enter 1. 

For an SSLC, enter 1, 2, or 3 where 

1 = Automatic code sensing of ASCII and EBCDIC if 

initially receiving; ASCII if initially send- 
ing; or for Hardwired Serial Interface (HSI). 

2 ~ ASCII transmission. 

3 = EBCDIC transmission. 

Select the most frequently used method of trans- 
mission because your response establishes the 
configuration default. In DSN/DS, all transmissions 
are ASCII. Only in certain other data communication 
subsystems can users optionally transfer EBCDIC 
characters . 



3.17 RECEIVE TIMEOUT? 

Enter the positive number of seconds the CS device 
will wait to receive text before terminating the 
read mode. Entering a carriage return provides a 
20-second timeout. 
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Step Dialogue 

No. 



NOTE 



For all timeout responses: Entering 
disables the timeout; maximum timeout is 
32000 seconds; DS displays an error when 
the communications software (CS) dis- 
coimects because of a timeout. 



3.18 LOCAL TIMEOUT? 



Enter the positive number of seconds a connected 
local station will wait to transmit or receive be- 
fore disconnecting. Entering a carriage return pro- 
vides a 60 -second timeout. (Your response is not 
used for DSN/DS activity.) 



3.19 CONNECT TIMEOUT? 



Enter the positive number of seconds the local sta- 
tion will wait after one attempt to make a connec- 
tion to a remote station. Entering a carriage return 
provides a 900-second timeout. For an HSI, 100 to 
500 is recommended. For an INP or SSLC, 300 is 
recommended. 



NOTE 



Steps 3 ♦SO through 3.22 apply only to CS 
devices with switched lines connected 
through a modem (dial telephones » Sub- 
tjrpe 0). For CS devices with non- 
switched lines connected through a modem 
(private lines » Subtype 1) the dialogue 
skips to Step 3.23. If the CS device is 
either an HSI or a hardwired INP (Sub- 
type 3)» the dialogue skips to Step 3* 25* 



3.20 DIAL FACILITY? 



Enter YES if manual dial-up is required. Enter INP 
LDEV# if the AUTO DIAL feature is used. Enter NO if 
no dial facility is required. 



A-9 



Configuration Dialogue 



Step Dialogue 

No. 



3.21 ANSWER FACILITY? 



Enter YES if the local modem can answer calls, 
either manually or automatically. Enter NO if it 
cannot. A NO response causes the next step to be 
skipped. 



3.22 AUTOMATIC ANSWER? 



Enter YES if the local modem can automatically an- 
swer calls. Enter NO if manual answering is 
required. 



3.23 DUAL SPEED? 



3.26 TRANSMISSION SPEED? 



For INP (Type 17) or SSLC (Type 18) devices, enter 
the transmission speed of the line in characters 
per second (Bit Rate/8). For HSI (Type 19) devices, 
enter 2|30 000 for cable lengths up to 1000 feet, or 
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Enter YES if the local modem is dual speed (European 
models). Enter NO if it is single speed. A NO re- 
sponse causes the next step to be skipped. 

3.2U HALF SPEED? 

Enter YES if the local modem is to operate at half 
speed. Enter NO if it is to operate at full speed. 
The dialogue skips to Step 3.26. 

3.23 SPEED CHANGEABLE? 

For an HSI, enter YES. ^ 

For an INP or an SSLC, enter YES if the speed of the 
line is changeable. Enter NO if the line speed is 
fixed. In general, the speed is changeable when the 
communications interface provides the clocking, and 
it is not changeable when a single -speed modem or 
other external device provides the clocking. You 
roust respond YES if the console operator will be 
using the speed parameter in the :DSCONTROL command 
to change the configured transmission speed (see 
Step 3.26). 
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Step Dialogue 

No. 



enter 12^ 000 for cable lengths greater than 1000 
feet. 

The transmission speed you specify is ignored for 
modems that provide internal clocking signals. This 
allows modems of different speeds to be used without 
reconfiguring the Operating System. The speed spec- 
ified is used if the modems are eliminated and the 
controllers are hardwired together. 

The speed you specify becomes the default. The con- 
sole operator can override the default by including 
the speed parameter in the :DSCONTROL command* 
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3-27 TRANSMISSION MODE? 

Enter the appropriate number for the transmission 
mode in use. The mode numbers are: 

= Full duplex 

1 = Half duplex 

INP and SSLC: 

Configure the communications interface (INP or SSLC) 
to operate in Full Duplex (0) if your facility uses 
one of the following: 

• A leased line with four-wire, point-to-point 
installation. 

f^ . A dial netwk with t» lines (fc„r-.ire 

equivalent). 

• A dial network with Wide Band Service. 

• Any Direct Connect cable between two INPs. 

Configure the communications interface to operate in 
Half Duplex (1) if your facility uses one of the 
following: 

• A dial network with a single -line (two -wire) 
installation. 



/^^^ 



• An INP- to -SSLC Direct Connect cable (a "modem 
eliminator'* cable between an INP and an SSLC). 

Your response must agree with the remote system's 
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Step Dialogue 

No. ^'^^^ 

configuration and with the characteristics of the 
commvmications line. 



HSI: 

Always configure an HSI as Full Duplex (0). 

3.28 PREFERRED BUFFER SIZE? 

Enter the desired buffer size in words » up to a max- 
imum of U095 words for an HSI or SSLC» or up to a 
maximum of 102U words for an INP. For a dial-up 
line, 1024 is generally recommended; for a leased 

line with an SSLC, the size may be larger than 102U ''^ 

if the line quality is good. Note that although 
large buffer sizes increase transmission efficiency, 
they also use up memoxy space. Match buffer sizes 
for sender and receiver whenever possible, since the 
effective buffer size that can be utilized is the 
smaller of the two. 

3.29 DRIVER CHANGEABLE? NO ^ 
3-30 DRIVER OPTIONS? 



NOTE 



The dialogue skips to Step 3 •50- -a*. 

3.U0 RECORD WIDTH? 

For lODSO, enter 128. 

For all Virtual Terminals, enter UO. 

3.I4I OUTPUT DEVICE? 

For the communications driver, enter zero. 

For a virtual terminal or a Packet Assembler/Disas- 
sembler (PAD) terminal, enter the class name or log- 
ical device number to be used for the corresponding 
job/session listing device. 
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Step Dialogue 

No. 



3.U2 ACCEPT JOBS/SESSIONS? 

For the communications driver, enter NO. 

For virtual terminals or PAD terminals, enter YES. 

3.U3 ACCEPT DATA? NO 

S.UU INTERACTIVE? 

For the communications drivers, enter NO. 
^^ For virtual terminals or PAD terminals, enter YES. 

3.U5 DUPLICATIVE? 

For the communications drivers, enter NO. 

For virtual terminals or PAD terminals, enter YES. 

3.U6 INITIALLY SPOOLED? NO 

3-50 DRIVER NAME? 



^P?N 



#^ 



Enter the name of the driver for this device as 
follows : 

lOINPO = INP 

CSSBSCO ^ SSLC 

CSHBSCO = HSI 

lODSO = Communications driver 

lODSX = Commiuiications driver, while utilizing 
the X.25 capability 

lODSTRMO = Virtual terminals 

lODSTRMX = Virtual terminals, while utilizing the 
X.25 capability 

lOPADO = Packet Assembler/Disassembler (PAD) 

terminals, while utilizing the X.29/X.25 
capability 
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Step 
No. 



Dialogue 



/^ 



NOTE 



Steps 3*52 through 3*55 apply to CS 
devices with switched (dial-up) lines 
(!Cypes 17 and 18, Subtype 0). The dia- 
logue for all other devices skips to 
Step 3.70. 



3.52 PHONELIST? 

Enter YES or NO. 

You can supply one number (usually a frequently 
dialed number) which will be the system default. 



3*53 PHONE NUMBER? 



Enter a string of ntunbers and hyphens, but not more 
than 30 characters* This number will be included in 
the I/O request on the system console when a user 
OPENS a dial-up (manual call) line. This number will 
be dialed automatically on an autodial line unless the 
user overrides with a phone number in the :DSLINE 
command . 



3 -51* LOCAL ID SEQUENCE? 



The default local ID sequence can be specified in 
terms of code or niimber system. Enter a carriage 
return for a null local ID sequence. Enter one of 
the letters below, followed by the ID sequence in 
quotes, if code, or parentheses, if number system. 

A = ASCII Example: A "JOE" 

E := EBCDIC Example: E "STRING" 

= Octal Example: (7» 35i 5) 

H = Hexadecimal Example: H (Al, IF, BB) 



/'ffi^^ 



NOTE 



Do not enter more than I6 characters for 
the local or remote ID sequence. 



><^^ 
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Step Dialogue 

No. 



3-55 REMOTE ID SEQUENCE? 



r 
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Enter the default remote ID sequence in the same 
format as the local ID sequence (above). This can be 
repeated mitil a carriage return is entered. 



3.70 DEVICE CLASSES? 



Enter a list containing a device class name (up to 
eight alphanumeric characters, beginning with a 
letter). Class names are separated from each other 
by commas. These names are left to the discretion 
of the System Supervisor. They will be used in 
certain commands and intrinsics when any member of a 
group of devices (such as any disc drive) can be 
referenced. No name need be entered. 



NOTE 



For lODSX entries, the destination logical 
node name cannot be specified as a device 
class name. (Refer to Appendix H. ) 

The dialogue now prints the LOGICAL DEVICE #? prompt 
described in Step 3. 5* If all I/O configuration is 
complete, press RETURN and the dialogue continues at 
Step 3*80. Otherwise, enter a logical device 
number and repeat the configuration procedure from 
Step 3.5* 



3.80 MAX # OF OPENED SPOOLFILES= xxx? return 



3.81 LIST OF I/O DEVICES? YES 

To print a listing of the new input /output device 
configuration, enter YES. This list appears in the 
format described in Step 3-2. 



3.82 LIST CS DEVICES? YES 

Enter YES to list the characteristics of the new CS 
device configuration. 
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Step Dialogue 

No. 



3.83 CLASS CHANGES? return 
3.93 LIST I/O DEVICES? return 



NOTE 



The prompt in Step 3.9*» appears only if 
a CS device is configured or if addi- 
tional drivers exist (for the CS driver- 
changeable option in Step 3-29). If 
neither case exists, the dialogue skips 
to Step U. 

3.9U ADDITIONAL DRIVER CHANGES? NO 

U SYSTEM TABLE CHANGES? NO 

3 HISC CONFIGURATION CHANGES? NO 

6 LOGGING CHANGES? NO 

7 DISC ALLOCATION CHANGES? NO 

8 SCHEDULING CHANGES? NO 

9 SEGMENT LIMIT CHANGES? NO 

10 SYsrm moGRm changes? no 

11 system sl changes? no 

The NO response ass\imes CS/3000 modules are alrea<ty 
present on the system. 

11.1 LIST LIBRARY? NO 

11.2 DELETE SEGMENT? NO ^ 
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Step Dialogue 

No. 



11 •a REPLACE SEGMENT? NO 
11.4 ADD SEGMENT? YES 

12 ENTER DUMP DATE? 

return Copies the modified MPE. When this copy 
is used to COLDSTART the system, the 
accoxuit structure and all files remain 
intact . 

mm/dd/yy where vm/dd/yy is some date in the 
future. Copies the modified MPE and the 
current accoimting, but no files* 

mm/dd/yy where mm/dd/yy is usually the date of the 
most recent system backup. Copies the 
modified MPE, the current accounting 
structure, and any files that were 
changed on or since the specified date. 

Copies the entire system (MPE, the 
current accounting structure, and all 
files). 



12.01 ENTER DUMP FILE SUBSETS? 

Enter a carriage return, or enter a filename or 
series of filenames. (Example: 6. PUB. SYS) 



12.1 LIST FILES DUMPED? YES or NO 



13 The console operator must now use the =REPLY command 
to assign the magnetic tape drive on which you have 
arranged for a fresh tape reel to be mounted. 



After the SYSDUMP is complete, the tape produced should be 
used to COLDSTART the system. During COLDSTART, the old I/O 
device configuration is replaced with the new one from your 
SYSDUMP tape. 
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ERROR CODES AND MESSAGES 



APPENDIX 



B 



The following is a sununary of the error code numbers and messages 
that may be encountered. The messages, as listed here, have been 
grouped Into several categories. For example, the first group 
contains all messages pertaining to :DSLINE syntax problems, 
while the second group contains the messages that report a DSN/DS 
functional problem. Each group is identified with an explanatory 
heading, and the messages are listed in numerical sequence within 
each category for easy reference. 



:DSLINE SYNTAX ERRORS 



These messages are sent to the terminal user to point out an 
error in syntax or to warn of the consequences of a request. 



1300 REMOTE JOBS ABE NOT ALLOWED I. (CIERR 1300) 

1301 DSLINE CANNOT CONTAIN BOTH OPEN AND CLOSE. (CIERR 1301) 

1302 DSLINE REQUIRES AT LEAST ONE PARAMETER. (CIERR 1302) 

1303 DSNUMBER SPECIFICATION MUST BE A NUMBER FROM 1 THRU 255- 
(CIERR 1303) 

I30U DSLINE #11 DOES NOT IDENTIFY AN OPEN DS LINE. (CIERR 130U) 
1303 EXPECTED LINEBUF, PHNUM, lOCID, REMID, OPEN, CLOSE, 
QUIET, COMP, NOCOMP, OR EXCLUSIVE. (CIERR I305) 

1306 MULTIPLE USE OF 1 IS NOT ALLOWED. (CIERR I306) 

1307 THE SYNTAX FOR ! REQUIRES AN = SIGN FOLLOWED BY DATA. 
(CIERR 1307) 

1308 PHNUM IS 1 TO 20 DIGITS AND DASHES. (CIERR I3O8) 

1309 i LIST CAN CONTAIN ONLY ONE ELEMENT. (CIERR I309) 

1310 THE SPECIFIED LOGICAL DEVICE IS NOT OPEN. (CIERR 1310) 

1311 THE FlkST CHARACTER OF AN ID SEQUENCE MUST BE A " OR A ( 
(CIERR 1311) 

1312 THE ID SEQUENCE MUST TERMINATE WITH A ) . (CIERR 1312) 

1313 THE ID SEQUENCE MUST TERMINATE WITH A ". (CIERR 1313) 
131^ A NUMERIC ID SEQUENCE ELEMENT MUST BE 1 THRU 235 (OR 

%3n). (CIERR I31U) 

1315 LINEBUF MUST BE A NUMERIC VALUE FROM 30U THRU I4O96. 
(CIERR 1315) 

1316 UNABLE TO COMPLETE THE REMOTE COMMAND. (CIERR I316) 

1317 NOT A CURRENTLY AVAILABLE DSLINE. (CIERR 1317) 

1318 USE OF EXCLUSIVE REQUIRES BOTH NS AND CS CAPABILITY. 
(CIERR 1318) 

1319 THE DS LINE #L1 IS IN USE BY A PROGRAM OR SUBSYSTEM AND 
CANNOT BE CLOSED. (CIERR 1319) 

1320 EXPECTED A RESPONSE OF YES, Y, NO, OR N. (CIERR 1320) 
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1321 UNABLE TO OPEN THE DS LINE ON DEVICE I . (CIERR 1321) 

1322 @ IS INVALID IN THIS CONTEXT. (CIERR 1322) 

1323 A DSLINE OPEN REQUIRES A VALID DS DEVICE NAME AS THE 
FIRST PARAMETER. (CIERR 1323) 

I32U FROM ADDRESS MUST BE BETWEEN 1 AND lU CHARACTERS INCLUSIVE. 

(CIERR I32U) 
1323 TO ADDRESS MUST BE BETWEEN 1 AND lU CHARACTERS INCLUSIVE. 

(CIERR 1325) 
1326 FRC»1 AND TO ADDRESS MUST BE A DECIMAL NUMBER. (CIERR I326) 

1392 ONLY i WORDS WERE ALLOCATED FOR THE LINE BUFFER. 
(CIWARN 1392) 

1393 COMPRESSION REQUEST NOT HONORED. REMOTE DOES NOT SUPPORT 
THIS FEATURE. (CIWARN 1393) 

139^ COMPRESSION PARAMETER RESPECIFIES AND OVERRIDES PREVIOUS 

COMPRESSION PARAMETER. (CIWARN 139U) 
1393 OPEN PARAMETERS ENTERED ON A CLOSE REQUEST ARE IGNORED 

(CIERR 1395) 

1396 AN ID LIST MUST CONTAIN 255 OR LESS ELEMENTS. 
(CIWARN 1396) 

1397 AN UNNECESSARY DELIMITER IS IGNORED. (CIWARN 1397) 

1398 THERE ARE NO DS LINES OPEN, (CIWARN 1398) 

1399 MULTIPLE USE OF ! IS REDUNDANT AND IGNORED. (CIWARN 1399) 



DSN/DS FUNCTrONAL ERRORS 

These messages report a functional problem within the system. 

201 REMOTE DID NOT RESPOND WITH THE CORRECT REMOTE ID. 
(DSERR 201) 

202 SPECIFIED PHONE NUMBER IS INVALID. (DSERR 202) 

203 REMOTE ABORT/RESUME NOT VALID WHEN DOING PROGRAM-TO- 
PROGRAM COMMUNICATION. USE LOCAL ABORT/RESUME. 

(DSWARN 203) ^ 

20U UNABLE TO ALLOCATE AN EXTRA DATA SEGMENT FOR DS/3000. ■ 

(DSERR 20U) 

205 UNABLE TO EXPAND THE DS/3000 EXTRA DATA SEGMENT. 
(DSERR 205) 

206 SLAVE PTOP FUNCTION ISSUED FROM A MASTER PROGRAM. 
(DSERR 206) 

207 SLAVE PTOP FUNCTION OUT OF SEQUENCE. (DSERR 207) 

208 MASTER PTOP FUNCTION ISSUED BY A SLAVE PROGRAM. 
(DSERR 208) 

209 SLAVE PROGRAM DOES NOT EXIST OR IS NOT PROGRAM FILE. 
(DSERR 209) 

210 WARNING — INVALID MAXDATA OR DLSIZE FOR A SLAVE PROGRAM. 
SYSTEM DEFAULTS ARE IN EFFECT. (DSWARN 210) 

211 SLAVE ISSUED A REJECT TO A MASTER PTOP OPERATION. 
(DSWARN 211) 

212 FILE NUMBER FROM lOWAIT NOT A DS LINE NUMBER. (DSWARN 212) 

213 EXCLUSIVE USE OF A DS LINE REQUIRES BOTH ND AND CS 
CAPABILITY. (DSERR 213) 
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2lU THE REQUESTED DS LINE HAS NOT BEEN OPEN WITH A USER :DSLINE 
COMMAND OR A REQUIRED : REMOTE HELLO HAS NOT BEEN DONE. 
(DSERR 2lU) 

213 DSLINE CANNOT BE ISSUED BACK TO THE MASTER COMPUTER. 
(DSERR 215) 

216 MESSAGE REJECTED BY THE REMOTE COMPUTER. (DSERR 2l6) 

217 INSUFFICIENT AMOUNT OF USER STACK AVAILABLE. (DSERR 217) 

218 INVALID PTOP FUNCTION REQUESTED. (DSERR 218) 

219 MULTIPLE POPEN. ONLY ONE MASTER PTOP OPERATION CAN BE 
ACTIVE ON A DS LINE. (DSERR 219) 

220 PROGRAM EXECUTING GET WAS NOT CREATED BY POPEN. (DSERR 220) 

221 INVALID DS MESSAGE FORMAT. INTERNAL DS ERROR. (DSERR 221) 

222 MASTER PTOP FUNCTION ISSUED PRIOR TO A POPEN. (DSERR 222) 

223 REQUEST TO SEND MORE DATA THAN SPECIFIED IN POPEN. 
(DSERR 223) 

22U FILE EQUATIONS FOR A REMOTE FILE CONSTITUTE A LOOP. 
(DSERR 22U) 

225 CANNOT ISSUE POPEN TO A SLAVE SESSION IN BREAK MODE. 
(DSERR 225) 

226 SLAVE PROGRAM HAS TERMINATED BEFORE EXECUTING "GET". 
(DSERR 226) 

227 REMOIS HELLO MUST BE DONE TO INITIATE REMOTE SESSION. 
(DSERR 227) 

228 EXCEEDED MAXIMUM NUMBER OF VIRTUAL CHANNELS PER JOB. 
(DSERR 228) 

231 INVALID FACILITY IN CONNECTION REQUEST. (DSERR 231) 

232 THE REMOTE COMPUTER IS NOT OBTAINABLE. (DSERR 232) 

233 VIRTUAL CIRCUIT IS NOT AVAILABLE. (DSERR 233) 

235 DS MESSAGE SEQUENCING ERROR. (DSERR 235) 

236 COMMUNICATIONS HARDWARE HAS DETECTED AN ERROR. (DSERR 236) 

237 CANNOT CURRENTLY GAIN ACCESS TO THE TRACE FILE. (DSERR 237) 

238 COMMUNICATIONS INTERFACE ERROR. INTERNAL FAILURE. 
(DSERR 238) 

239 COMMUNICATIONS INTERFACE ERROR. TRACE MALFUNCTION. 
(DSERR 239) 

2U0 LOCAL CCMMUNICATION LINE WAS NOT OPENED BY OPERATOR. 

(DSERR 2U0) 
2Ul DS LINE IN USE EXCLUSIVELY OR BY ANOTHER SUBSYSTEM. 

(DSERR 2Ul) 
2U2 INTERNAL DS SOFTWARE ERROR ENCOUNTERED. (DSERR 2U2) 
2U3 REMOTE OR PDN IS NOT RESPONDING. (DSERR 2U3) 
2UU COMMUNICATIONS INTERFACE ERROR. LINE RESET OCCURRED. 

(DSERR 2kk) 
2U5 COMMUNICATIONS INTERFACE ERROR. RECEIVE TIMEOUT. 

(DSERR 2U5) 
2U6 COMMUNICATIONS INTERFACE ERROR. REMOTE DISCONNECTED. 

(DSERR 2U6) 
2U7 COMMUNICATIONS INTERFACE ERROR. LOCAL TIME OUT. (DSERR 2U7) 
2U8 COMMUNICATIONS INTERFACE ERROR. CONNECT TIME OUT. 

(DSERR 2U8) 
2U9 COMMUNICATIONS INTERFACE ERROR. REMOTE REJECTED 

CONNECTION. (DSERR 2t49) 

250 COMMUNICATIONS INTERFACE ERROR. CARRIER LOST. (DSERR 250) 

251 COMMUNICATIONS INTERFACE ERROR. LOCAL DATA SET FOR THE 
DS LINE WENT NOT READY. (DSERR 251) 
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2^2 COMMUNICATIONS INTERFACE ERROR. HARDWARE FAILURE. 

(DSERR 232) 
233 COMMUNICATIONS INTERFACE ERROR. NEGATIVE RESPONSE TO THE 

DIAL REQUEST BY THE OPERATOR. (DSERR 253) 
251+ COMMUNICATIONS INTERFACE ERROR. INVALID I/O CONFIGURATION. 

(DSERR 25U) 
255 COMMUNICATIONS INTERFACE ERROR. UNANTICIPATED CONDITION. 

(DSERR 255) 



:DSCONTROL INFORMATORY MESSAGES 



These messages convey status information. 



300 DS 

301 DS 

302 DS 

303 DS 
30i» DS 

305 DS 

306 DS 

307 DS 

308 DS 

309 DS 

310 DS 

311 DS 

312 DS 

313 DS 
31^ DS 



DEVICE 
DEVICE 
DEVICE 
DEVICE 
DEVICE 
DEVICE 
DEVICE 
DEVICE 
DEVICE 
DEVICE 
DEVICE 
DEVICE 
DEVICE 
DEVICE 
DEVICE 



MASTER AND SLAVE ACCESS SHUT. 

SLAVE ACCESS OPENED; MASOER ACCESS SHUT. 

MASTER ACCESS OPENED; SLAVE ACCESS SHUT. 

MASTER AND SLAVE ACCESS OPENED. 

TRACE ACTIVATED USING TRACE FILE 1 . 

TRACE DEACTIVATED. 

MONITORING ACTIVATED. 

MONITORING DEACTIVATED. 

DEBUG MODE ACTIVATED. 

DEBUG MODE DEACTIVATED. 

SPECIAL DEBUG MODE ACTIVATED. 

DEFAULT MODE IS NO COMPRESSION. 

DEFAULT MODE IS COMPRESSION. 

RETRY COUNT NOW EQUALS ! . 

CALL REQUEST CANCELED. 



:DSCONTROL ERROR MESSAGES 



These messages point out an error in syntax 
consequences of a request. 



or warn of the 



UlOO NUMBER OF PARAMETERS EXCEEDS MAXIMUM OF 1 . (CIERR UlOO) 
UlOl EXPECTED AT LEAST TWO PARAMETERS: A DS DEVICE 

CLASS /NUMBER AND A FUNCTION KEYWORD. (CIERR UlOl) 
UIO2 EXPECTED A DEVICE CLASS NAME OR LOGICAL DEVICE NUMBER FOR 

ONE OR MORE DS DEVICES. (CIERR Ul02) 
UIO3 USER IS NOT ASSOCIATED WITH DS DEVICE ! . NO CONTROL 

FUNCTIONS EXECUTED FOR THIS DEVICE. (CIWARN Ul03) 
UlOU USER IS NOT ALLOWED TO USE :DSCONTR0L AND IS NOT ASSOCIATED 

WITH THE DS DEVICE (S). (CIERR UlO^) 
UIO5 EXPECTED ONE OR MORE OF THE CONTROL FUNCTIONS: OPEN, SHUT, 

MON, MOFF, COMP, NOCOMP, TRACE, OR DEBUG. (CIERR UIO5) 
UIO6 INVALID CONTROL FUNCTION. EXPECTED ONE OF: OPEN, SHUT, 

MON, MOFF, COMP, NOCOMP, TRACE, OR DEBUG. (CIERR U106) 
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UIO7 MASTER OVERRIDES PREVIOUS MASTER/SLAVE OPTION. 

(CIWARN UIO7) 
UIO8 SLAVE OVERRIDES PREVIOUS MASTER/SLAVE OPTION. 

(CIWARN UIO8) 
UIO9 SPEED OPTION OVERRIDES PREVIOUS SPEED OPTION. 

(CIWARN UIO9) 
UllO OPEN OVERRIDES PREVIOUS OPEN/SHUT FUNCTION. (CIWARN UllO) 
Ulll SHUT OVERRIDES PREVIOUS OPEN/SHUT FUNCTION. (CIWARN Ulll) 
UII2 TRACE OVERRIDES PREVIOUS TRACE FUNCTION (S). (CIWARN Ull2) 
UII3 DEBUG OVERRIDES PREVIOUS DEBUG FUNCTION (S). (CIWARN Ull3) 
UllU MON OVERRIDES PREVIOUS MON/MOFF FUNCTION. (CIWARN UllU) 
ltll5 MOFF OVERRIDES PREVIOUS MON/MOFF FUNCTION. (CIWARN UII5) 
kll6 COMP OVERRIDES PREVIOUS COMP/NOCOMP FUNCTION. (CIWARN UII6) 
UII7 NOCOMP OVERRIDES PREVIOUS COMP/NOCOMP FUNCTION. 

(CIWARN UII7) 
1*118 EXPECTED A ";" , "," , OR RETURN AS DELIMITER. (CIERR UII8) 
UII9 EXPECTED EITHER A ";" OR RETURN AS DELIMITER. (CIERR UII9) 
1»120 EXPECTED A "=" AS DELIMITER FOR SPEED OPTION. (CIERR Ul20) 
U12I EXPECTED A "," AS DELIMITER BETWEEN OPTIONS. (CIERR Ul2l) 
U122 ILLEGAL OPEN/SHUT OPTION. EXPECTED ONE OF: MASTER, SLAVE, 

SPEED, OR LINESPEED VALUE. (CIERR Ul22) 
lH23 EXPECTED A POSITIVE DOUBLE VALUE FOR LINESPEED. 

(CIERR UI23) 
U12U CS CAPABILITY REQUIRED TO USE :DSCONTROL. (CIERR Ul2U) 
U125 PM CAPABILITY REQUIRED TO USE DEBUG FUNCTION. (CIERR Ul25) 
U126 DEBUG FUNCTION MAY ONLY BE USED BY SYSTEM CONSOLE. 

(CIERR U126) 
U127 EXPECTED NO OPTION FOR DEBUG OR ONE OF THE FOLLOWING: 

ON, OFF, OR POSITIVE INTEGER VALUE. (CIERR Ul27) 
1*128 EXPECTED NO OPTION FOR MON/MOFF OR ONE OF THE FOLLOWING: 

CS OR DS. (CIERR Ul28) 
U129 CC»1P/N0CCMP FUNCTIONS HAVE NO OPTIONS. (CIERR 1»129) 
U13O SPEED OPTION IGNORED FOR SHUT FUNCTION. (CIWARN U13O) 
U13I EXTRANEOUS ";" IGNORED. POSSIBLE MISSING FUNCTION? 

(CIWARN U13I) 
I4I32 EXTRANEOUS "," IGNORED. POSSIBLE MISSING OPTION? 

(CIWARN 1+132) 
U133 CREATION OF DS MONITOR PROCESS FAILED. (CIERR 1»133) 
Ul3l» PROGRAM FILE "DSMON.PUB.SYS" MISSING. (CIERR Ul3l*) 
U135 DS MONITOR UNABLE TO RUN AS A SYSTEM PROCESS. (CIERR 1*135) 
U136 CS DEVICE 1 IS UNAVAILABLE FOR USE. (CIERR U136) 
1*137 DS DEVICE MUST BE OPEN PRIOR TO USE. (CIERR 1*137) 
1*138 USER SPECIFIED TRACE FILE NOT ALLOWED WHEN MORE THAN ONE 

DEVICE IN DEVICE CLASS. (CIERR U138) 
1*139 DS DEVICE 1 CURRENTLY CONTROLLED ELSEWHERE. (CIWARN 1*139) 
1*1 UO DS DEVICE i: OPEN/SHUT NOT EXECUTED DUE TO ABOVE. 

(CIWARN 1*11*0) 
1*11*1 DS DEVICE !: TRACE NOT EXECUTED DUE TO ABOVE. (CIWARN l*ll*l) 
1*11*2 DS DEVICE !: MON/MOFF NOT EXECUTED DUE TO ABOVE. 

(CIWARN 1*11*2) 
1*11*3 DS DEVICE I: COMP/NOCOMP NOT EXECUTED DUE TO ABOVE. 

(CIWARN 1*11*3) 
l*ll*l* DS DEVICE 1 : DEBUG NOT EXECUTED DUE TO ABOVE. (CIWARN klkk) 
1*11*3 NO DS DEVICES REMAINING TO BE CONTROLLED. (CIWARN U1U3) 
1*11*6 RETRY OVERRIDES PREVIOUS RETRY FUNCTION. (CIWARN l*ll*6) 
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U1U7 EXPECTED AN "=" AS DELIMITER FOR RETRY FUNCTION. 

(CIERR UiU7) -^ 

1*1U8 INVALID RETRY COUNT, MUST SPECIFY "DEFAULT" OR A NUMBER ) 

BETWEEN AND 255 INCLUSIVE. (CIERR U1U8) 
UIU9 DS DEVICE ! : RETRY NOT EXECUTED DUE TO ABOVE. (CIWARN U1U9) 
UI50 DS INTERNAL FIX NUMBERS DIFFER. (CIWARN U15O) 
U15I INCOMPATIBLE OR MISSING NONCRITICAL DS MODULE: DSCOPY, 

DSTEST, DS2026, OR DS2026CN. (CIWARN U15I) 
U152 CRITICAL DS MODULES ARE INCOMPATIBLE, NO CONTROL FUNCTIONS 

EXECUTED. (CIERR Ul52) 
U153 MISSING CRITICAL DS SOFTWARE, NO CONTROL FUNCTIONS EXECUTED. 

(CIERR U153) 
U15U REMOTE PROMPT MUST BE 1 TO 8 PRINTABLE CHARACTERS. 

(CIERR U15U) 
U155 PROMPT OVERRIDES PREVIOUS PROMPT FUNCTION(S). (CIERR '♦155) 



:DSCOPY GENERAL ERROR MESSAGES ^ 

SUCCEEDED. 

1 SUCCESSFULLY INITIATED. 

1» UNABLE TO OPEN TRANSACTION FILE. (NFTERR U) 

5 UNABLE TO OPEN LIST FILE (DSCOPYI). (NFTERR 5) 

6 IC ERROR ON TRANSACTION FILE. (NFTERR 6) 

7 TRANSACTION RECORD > 200 CHARS LONG. (NFTERR 7) 

9 TEMPORARY TRANSACTION FILE FULL. (NFTERR 9) ^ 

10 PARAMETERS IMPLY CONFLICTING MODES. (NFTERR 10) 

11 CAN'T "RUN" COPY PROCESS IN THIS MODE. (NFTERR 11) 
13 UNRECOGNIZED PARAMETER. (NFOSIRR 13) 

li» CONFLICTING OPTIONS HAVE BEEN SPECIFIED. (NFTERR lU) 

16 UNIMPLEMENTED FEATURE. (NFTERR I6) 

17 CANNOT CONTACT REMOTE NODE. (NFTERR 17) 

18 FILE SYSTEM ERROR ON SOURCE FILE. (NFTERR I8) 

19 FILE SYSTEM ERROR ON TARGET FILE. (NFTERR 19) ^—^ 
21 ILLEGAL DSLINE NAME. (NFTERR 21) ^ 
2U UNSUPPORTED STANDARD DEVICE TYPE. (NFTERR 2lt) 

25 CAN'T FIND OR OPEN THE SOURCE FILE. (NFTERR 25) 

26 CAN'T CREATE OR OPEN THE TARGET FILE. (NFTERR 26) 

27 CANNOT CONTACT REMOTE SYSTEM. (NFTERR 27) 

28 SOURCE AND TARGET FILES CANNOT BE ACCESSED THROUGH REMOTE 
FILE ACCESS. (NFTERR 28) 

29 CC91MUNICATI0N 10 ERROR. (NFTERR 29) 

30 INSUFFICIENT CAPABILITIES. (NFTERR 30) 

33 NO SOURCE FILE WAS SPECIFIED. (NFTERR 33) 

36 DS/3OOO HAS NOT BEEN INSTALLED ON THIS SYSTEM. (NFTERR 36) 

37 REMOTE SYSTEM UNABLE TO USE TRANSPARENT MODE. (NFTERR 37) 

38 CAN'T FIND raE EXTRA DATA SEGMENT, USE THE DSCOPY INTRINSIC 
TO INVOKE NFT. (NFTERR 38) 

39 INVALID EXTRA DATA SEGMENT CONTENTS, USE THE DSCOPY INTRINSIC 
TO INVOKE NFT. (NFTERR 39) , . 

1*0 NEGOTIATIONS FAILED, NO COPY CAN BE PERFORMED. (NFTERR 40) ^ 

Ul FILE TRANSFER ABORTED. (NFTERR Ul) ) 

U2 COPY CANCELLED BY USER. (NFTERR U2) 
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:DSCOPY INTRINSIC ERROR RETURNS 



80 BOUNDS VIOLATION. (NFTERR 80) 

81 SPLITSTACK MODE CALLS NOT ALLOWED. (NFTERR 8l) 

82 FIRST PARAMETER VALUE IS OUT OF RANGE (-1:6). (NFTERR 82) 

83 SECOND PARAMETER TOO SHORT TO CONTAIN VERSION STRING. 
(NFTERR 83) 

8U NFT PROCESS IS BUSY, CAN'T START NEW TRANSACTION. 

(NFTERR 8U) 
8^ NFT PROCESS IS NOT RUNNING. (NFTERR 8^) 
86 ILLEGAL BASIC CALLING SEQUENCE. (NFTERR 86) 



:DSCOPY INTERNAL ERRORS 



101 INTERNAL ERROR ON REMOTE SYSTEM. (NFTERR 101) 

102 REMOTE SYSTEM NFT VERSION IS INCOMPATIBLE. (NFTERR 102) 

103 INTERNAL - STRING STORAGE OVERFLOW. (NFTERR 103) 

lOU UNABLE TO CREATE TEMPORARY TRANSACTION FILE. (NFTERR lOU) 
103 AN UNEXPECTED MESSAGE WAS RECEIVED. (NFTERR 103) 

106 AN ILLEGAL VALUE WAS RECEIVED IN A MESSAGE. (NFTERR 106) 

107 A MESSAGE RECEIVED IN INVALID FORMAT. (NFTERR 107) 

108 A REQUIRED ELEMENT WAS MISSING FROM A RECEIVED MESSAGE. 
(NFTERR 108) 

109 NFT PROCESS CREATE FAILED. (NFTERR 109) 

110 ATTEMPT TO GET EXTRA DATA SEGMENT FAILED. (NFTERR 110) 
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Before establishing a DSN/DS communications link^ the console 
operator's : DSCONTROL command must be used to OPEN a line» so 
that it is available to DSN/DS users. The : DSCONTROL command 
allows you to enable or disable the DSN/DS subsystem on a 
specific communications link* 

For easy reference » this command is shown in the following 
format : 



• SYNTAX 

# PARAMETERS 

• OPERATION 

# EXAMPLES 



Shows the format of the command. 
Describes the variables in the command. 
Describes the command in detail. 
Shows the command in use. 
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:DSCONTROL 



SYNTAX 



:DSCONTROL dsdevice; function [; function [;... function]] 



where the conunand syntax has the following meaning: 

function — OPEN [, open option [,.. .open option] ] 

SHUT 





TRACE 9 ON [trace options] 
TRACE, OFF 




COMP 
NOCOMP 




MON [,raon option] 

MOFF 

RETRY= [retry option] 


open option 


- MASTER 
SLAVE 
[SPEED=] linespeed 


trace options - 


[ y [ALL] [ , [mask] [ y [nument 
[, filename]]]]] 


mon option 


- DS 
CS 


retry option 


- DEFAULT 
count 



PARAMETERS 

dsdevice 



The logical device number or the device 
class name of the DSN/DS communications 
device. On your system's I/O configuration 
listing » the device is back referenced by 
a poxind sign (#) to a previously defined 
INP, HSI, or SSLC, (Required parameter.) 



>^^ 



OPEN 



Establishes a commimication link with 
another HP 3000. Makes the line available 
for remote communication via the DSN/DS 
Subsystem. (Required parameter.) 
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SHUT 



Initiates an orderly line shutdown. Refer 
to OPERATION for details about the line 
closing procedure* 



MASTER 



Limits DSN/DS 
requests only, 
are allowed. 



line activity to outgoing 
No incoming slave sessions 



SLAVE 
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linespeed 
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Limits DSN/DS line 
slave requests only; 
activity is allowed. 



activity to incoming 
no outgoing master 



Default: Both MASTER and SLAVE processing 
are allowed. 



Transmission rate in characters per 
second. This parameter is effective only 
if your system generation for the line 
selected SPEED CHANGEABLE. Specify 
linespeed if yours is a European installa- 
tion with modems running at half speed, or 
if the line is hardwired and you want to 
override the configured default. It may 
be necessary to include this parameter if 
the length of cables used for HSI communi- 
cations has been changed since the system 
was configured. 

HSI speed: 250,000 (cable lengths 

less than 1000 ft.) 

125,000 (cable lengths 
greater than 1000 ft . ) 

INP or SSLC speed: 250, 300, 600, or 1200 

Remember, both ends of the line must 
operate at the same speed. 

Default: System configuration values. 



TRACE, ON 



1^^ 



Activates the TRACE facility to provide a 
record of communications activities. Trace 
parameters are positional. The line must 
already be open, or the OPEN keyword must 
also be included (to open the line). 
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ALL 



Generates trace records for all line 
activity. 

Default: Records are written only for 
transmission errors. 



mask 



An octal number preceded by a percent sign 
(%nn). Used to select type of trace 
entries generated. Refer to Appendix D 
for an explanation of the mask bits. 

Default: JS37 (all except PSTN). 



nuroentries 



Decimal integer for the maximum number of 
entries in a trace record, not greater 
than 2U8. 

Default: 2k. (See OPERATION.) 



WRAP 



Trace entries that overflow the trace 
record overlay the prior trace record 
entries • 



filename 



Default: Overflow entries are discarded* 



A name for the trace file. 



Default: DSTRCxxx.PUB.SYS (where xxx is 
the Idn of the dsdevice). 



TRACE, OFF 



Deactivates the TRACE facility, so that no 
records are kept of DSN/DS actions, 
states, and events. Also closes the trace 
file. 



COMP 



Activates the data compression facility 
for all line users. The line need not be 
open to use COMP. 



NOCOMP 



Deactivates the data compression facility 
for all line users. The line need not be 
open to use NOCCMP. 
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MON 
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Activates internal communication monitor- 
ing activity to give additional inform- 
ation on a subsequent cold dxunp of the 
system. The line must be open for the use 
of HON. 

MON Requests monitoring of all 
levels of act ivity . 

MON,DS Requests monitoring at the 
DSN/DS level of internal soft- 
ware operation. 

MON,CS Requests monitoring at the 
Communication System level of 
internal software operation. 

Default: No monitoring. 

Used only for system troubleshooting. 



MOFF 






RETRY= r DEFAULT 
L count 



^^ 



Deactivates internal DSN/DS monitor 
records. Line must be open for the use of 
MOFF. 



Changes the communications error retry 
count to the specified value. The retry 
counter controls the number of times the 
system attempts to send or receive a mes- 
sage across a DS line. 

DEFAULT Specifies a limit of 15 retries 
when a line error occurs. 



count Can be any value 
range of to 255* 

Default: 15- 



within the 



^^ 
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OPERATION 



Unless rDSCONTROL is issued from the master console* this 
command requires the user to have CS capability • In addition, 
all users except the console operator are granted access to 
:DSCONTROL only if they are ALLOWed to use the command and are 
ASSOCIATEd with the specified DS device. 

Only one DSN/DS communications device can be active (OPEN) on 
a controller at any given time. Once opened (with the 
:DSCONTROL command), a communications link can be shared by 
multiple DSN/DS users. It cannot, however, be shared by 
users of other communications subsystems supported by your 
system (for example, DSN/MRJE). Thus, you must SHUT the 
DSN/DS commxmications device before the controller can be 
opened for use by another subsystem. 

Before issuing a :DSCONTROL command, use the tSHOVJDEV command 
to check whether a communications link is already established. 
The Idn for the INP, SSLC, or HSI port will be UNAVAILable if 
the communications link is in use by any subsystem; the Idn 
for a DSN/DS communication pseudo device (driver lODSO or 
lODSX) will be AVAILable if it is currently OPEN for use by 
DSN/DS users. 

If a DS device class includes more than one DS device, the 
functions specified in the rDSCONTROL command apply to all 
devices in that class. If you have not been ALLOWed to use 
this command, you can only control those devices in the device 
class with which you have been ASSOCIATEd (if any). 

If you include more than one function in a rDSCONTROL command, 
each function (with its subparameter list) must be separated 
by a semicolon. A function that duplicates or conflicts with 
a previous function overrides that function. Functions can 
appear in any order but are executed in the following order: 

1. OPEN/SHUT 

2. TRACE 

3. MON/MOFF 

k. COMP/NOCCMP 



The SPEED= keyword in the open option may be omitted from a 
:DSCONTROL command. For example, the following two commands 
have exactly the same effect: 

:DSCONTROL 60; OPEN, MASTER, SPEED=25000 

:DSCONTROL 60; OPEN, MASTER, 25000 
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The name of the trace file is: 

DSTRCxxx . PUB . SYS 

irtiere xxx is the logical device number of the dsdevice« 

If no trace file exists when you turn on the trace facility and 
you do not specify numentries* the system creates a file to hold 
2^ entries in each record. 

The SHUT parauneter initiates an orderly line closing pro- 
cedure. If no sessions or applications are using the line 
when you shut it, line disconnection occurs immediately. If 
any user (including applications) has the line open, the line 
remains connected until all sessions and applications CLOSE 
the line, or until those accessing the line terminate or are 
aborted. Once closed by the console operator, no new users 
may access the line until the operator reopens it. When using 
the X.25 capability of DSN/DS, the SHUT parameter disconnects 
the line immediately, even if there are current users on the 
line. 



NOTE 



Occasionally you may not be able to SHUT a 
standard (non-X.25} DS line. This could 
happen, for example, if a DS user forgot to 
issue a :DSLINE xxx;CLOSE command but still 
has a local session. It could also happen if 
a remote session is "hung". In such a situa- 
tion, you can "KILL" all activity across the 
line by issuing an :ABORTIO xxx (where xxx is 
the logical device number of the dsdevice). 
Following the use of the lABORTIO xxx com- 
mand, a second :DSCONTROL xxx; SHUT command 
will complete successfully. 
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EXAMPLES 



To open DS line number 55 ♦ thereby making it available for use 
by the DSN/DS Subsystem » enter: 

:DSCONTROL 55; OPEN 



To permit the local HP 3000 to process only master (outgoing) 
requests on DS line number 55, enter: 

:DSCONTROL 55; OPEN, MASTER 



To activate the CS Trace facility for DS line 55 (the line is 
already open), enter: 

:DSCONTROL 55;TRACE,ON,ALL 



To open DS line 55 and activate CS Trace with a maximum of 250 
entries in a trace record, enter: 

:DSCONTROL 55;OPEN;TRACE,ON, ^ ,250 



To open the line named REMSYS and provide compression and 
internal monitoring, enter: 

:DSC0NTR0L REMSYS; OPEN; COUP ;MON 
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The DSDUMP program is a CS Trace Facility analyzer that formats 
and dumps DSN/DS messages from a CS Trace file* DSDUMP is a 
supi>ort tool to be used in conjunction with CSDUMP (not as a 
replacement for CSDUMP). The program can be run either inter- 
actively or in batch mode. DSDUMP has several commands that 
allow you to specify certain messages to be formatted. In 
addition to the formatted DS messages, the OPR id and CMP id, as 
well as any error code for the formatted DS message, is printed. 
However, the OPR id is not printed when the ERRORS option is 
turned on, but the OPR id for any DS message should be obvious. 
VDien the DSDUMP program is being run in a job, a file equation is 
needed for the CSTRACE file. Otherwise, the file equation is 
optional, since you will be prompted for the CSTRACE file name if 
the FOPEN to the CSTRACE file fails. 



The file equation for the CS Trace file is: 






•FILE CSTRACE=CS trace file name 



DSDUMP COMMANDS 



The commands used with the DSDUMP program are as follows: 



CLEAR Resets all options to their default values. 

DATA= Places a limit on the number of words in the data 
section to be printed per DS message. 

DISPLAY Shows the status of all commands and parsimeters. 

ERRORS To format only those DS messages whose completion 
entry has an error code not equal to zero. 



EXIT 



Terminates the program. This command may be used 
amy time the user is prompted. 
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GO 



To get out of the Command Interpreter and start 
the dump. 
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HELP For an explanation of the commands. HELP does not 
accept any parameters. (Only allowed in a 
session.) 

ONES To include idle (-1) DS messages in the dump. The 
default is to exclude these messages. 

NEWDEV To specify a new output device. (Only allowed in 
a session.) 

NEWFILE To change CSTRACE files. (Only allowed in a 
session.) 

PINS= To format only those DS messages whose To or From 
PIN is equal to one of the specified PINs. (A 
maximum of ten PINs is permitted.) 

RANGE To find the trace times of the first and last 
entries . 

TIMES= To format only those DS messages vdxose trace times 
are within the specified range. 

TYPES= To format only the specified type of DS messages. 
The parameters for the TYPES= command are: 



COMMANDS Formats the REMOTE command, Remote 

HELLO , Remote BYE, Control-Y message, 
BREAK message, RESUME message, ABORT 
message, KILLJOB message, and First 
Slave DSOPEN. 

PTOP Formats PREAD, PWRITE, PCONTROL, 

POPEN, PCLOSE, ACCEPT, and REJECT. 

RFA Formats RFA and IMAGE messages. 

RTE Formats RTE DS messages. 

QTOQ Formats Q^OQ (NFT) DS messages. 

TERMINAL Formats PRINT messages, READ and READX 
messages, and FCONTROLs to the 
terminal. 



Several commands can be combined on one line if they are 
delimited (separated) with a semicolon (;). All parameters for a 
command must be on the same line. VOien the PINS= commatnd or the 
TYPES=: command are entered several times, they do not cancel the 
previous command, but instead they are added to the previous 
parameters. The PINS= command checks for duplicate PINs. A new 
TIMES= or DATA'S command, however, does replace the previous 
command. If a colon (:) is typed in the first column of a line. 
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DSDUMP 

that line is assmned to contain an MPE command* An End-of-File 
will initiate the dump. The default designator is $STDINX. The 
command file may be equated to $NULL if no options are desired. 
If you are having all messages formatted (including idle 
messages), then sequence numbers will be included in the output. 

The file equation for the Command Interpreter is: 

:FILE COMFILE^'command file name 



OPERATION 



When the DSDUMP program begins, a procedure is called to read the 
driver name from the first COPEN intrinsic entry. This begins in 
word 5* The WHO intrinsic is used to determine whether it is in 
batch mode or interactive mode. If it is interactive, you are 
queried as to where you want your output sent. After the FOPEN 
for the output is done, the Commsind Interpreter is called. Then, 
after the commands are read, the program processes the data. 
There is a procedure for HSI drivers and another for INP and SSLC 
drivers . 

The procedure for the HSI driver entries does a search for STX 
and EDT entries. EDT entries contain receive-text DS messages if 
word 5 is a 5tl2. EDT's word 6 contains the length of the DS 
message before truncation. If this length is greater tham 26 
bytes (the maximum number of bytes for which the data segment has 
space), the length is set to 13 words. The length of STX DS 
messages is determined by bits 11:5 of word of the entry. This 
is the length of the entire entiy. The length of the header 
(five) is subtracted from this value to get the length of the DS 
message. The DS message is simply extracted "as is" and the 
FORMAT procedure is called to output it. 

The procedure for traces from INP and SSLC drivers looks for STX 
and RTX entries.. When they are found, their data section is 
searched for protocol start -texts (DLE STX) . The data from this 
point until a corresponding entry's protocol end-text (DLE ETX) 
is found is then put into a buffer, omitting any control 
characters. When the ETX is found, the FORMAT procedure is 
called to format the DS message (s). 

Both procedures check for overlaid or tmncated records, as well 
as searching for OPR id and CMP id. It is these procedures which 
also handle the TIMES= and ERRORS options. 
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Preparation 



The DSDUMP program file is prepared with STACK=:3000 and MAXDATA= 

25000. 



Running tlie Program Interactively 



Vlhen the DSDUMP program is being run interactively » it is not 
necessary to specify any file equations* DSDUMP commands can be 
read from a file* but a file equation for the output file is not 
permitted. The program will ask you whether you want the output 
to go to the terminal or to the printer. If you don't specify a 
device , the program defaults to LP. If no priority is specified « 
the default is 6. After the FOPEN has been performed , you will 
be prompted for commands. If the output is going to the printer , 
all DSDUMP commands are echoed. If the output is going to the 
terminal, then after all messages have been listed, the CSTRACE 
file is rewound and control goes to the Command Interpreter. 
Also, when output is going to the terminal, typing a Control-Y 
will cause the CSTRACE file to be rewound and contol to go to the 
Command Interpreter. VBien the program returns to the Command 
Interpreter (CI), the input is then read from $STDINX rather than 
COMPILE. 
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Streaming the Program 

A file equation for the CS trace file is required for batch jobs. 

However, file equations for the command input file and the output 

files are optional, since the default designators are $STDINX and ^^^ 

$STDLIST. The formal designator for the list file is DSLIST. ^ 

The HELP, MEVn)EV, and NEWFILE commands are ignored in batch mode. 

Any error in the command file will terminate the program. If 

command input is supplied on $STDINX, it must be terminated by 

:EOD if the GO command is not used. 



Output 

Output on the printer includes the name of the CS trace file and 
the date of the trace file in the heading. Also included is the 
CS LDEV and the name of the driver. Messages from sent-text 
entries appear on the left side and received messages are on the 
right side. 
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Operating Tips 

When using the TIMES= command, be sure to specify the upper bound 
a little higher than you actually want it. This is to ensure 
that you get all the desired entries • This technique is 
necessary because the clock on the INP is accurate to hundredths 
of seconds irtiile the mainframe clock is accurate to milliseconds, 
and DSDUMP tests the millisecond trace times against an upper 
boiind that is accurate to hundredths of seconds. It is also 
possible that you may not get all the messages you wanted if you 
use the TIMES= command when the trace has already been running 
for a while. This is a result of the INP and mainframe clocks 
getting out of synchronization, which can cause later trace times 
to be less than previous trace times. There is still a 
possibility that DS messages can be truncated by DSDUMP (as it 
was with CSDUMP) if the niimentries parameter in the DSCONTROL 
statement is small. Therefore, take caution to prevent 
misinterpretation of later messages. 
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APPENDIX 



Both the system software and the physical link cozmecting the 
computers can be tested with a diagnostic program called 
DSTEST. DSTEST conducts a simple, yet effective, test of the 
system, including Remote File Access (RFA) and Program- to -Program 
(prop) communications. 



DSTEST can run in Diagnostic or Normal mode. In the Diagnostic 
mode of DSTEST, you can select the number of passes, the word 
pattern to be transmitted, the mode of transmission, and the 
block size. In the Normal mode, DSTEST automatically assigns 
typical values for each option. An additional entry point 
provides a report of the version and fix level of DS and CS 
software installed on a system. 



^^\ 



NOTE 



To perfonn DSTEST, you must have a remote 
session. Also, remote command execution can 
be used independently of DSTEST for checkout 
of the various system configurations. 
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SOFTWARE VERSION REPORT 



The DSTEST program has an alternate entry point idiich provides 
a list of the software module version numbers for the DSN/DS 
modules installed on your system. This list must be available 
for all troubleshooting activities, and it must accompany each 
Service Request (SR) that you submit to your HP Systems Engineer 
(SE). 



In order to obtain the list, you must have READ access to the 
DSN/DS program files in PUB. SYS. The command syntax is: 



:RUN DSTEST. PUB. SYS, VERS 



E-1 



System Verification 



Version Report Example 



; RUN DSTEST. PUB ♦SYS. VERS 

HEWLETT PACKARD 32190A.03.0U DSTEST/3000 THU, OCT 7,1982, l:l8 PM 



MODULE 
SL MODULE 
SL MODULE 
SL MODULE 
DSCOPY 
DSMON 
DSTEST 
DS2026 
DS2026CN 
DSDUMP 
lODSO 
lODSTRMO 
DSMONX 
lODSX 
lODSTRMX 
lOPADO 
NETCONF 
CS 



00 
01 
02 



VERSION 
A.OU.Ol 
A.OU.Ol 
A.OU.Ol 
A.OU.Ol 
A.OU.Ol 
A.OU.Ol 
A.OU.Ol 
A.OU.Ol 
A.OU.Ol 
A.OU.Ol 
A.OU.Ol 
A.OU.Ol 
A.OU.Ol 
A.OU.Ol 
A.OU.Ol 
A. 05. 03 
A. 05. 03 



INTERNAL FIX 002 
INTERNAL FIX 002 
INTERNAL FIX 000 
INTERNAL FIX 001 
INTERNAL FIX 002 
INTERNAL FIX 001 
INTERNAL FIX 000 
INTERNAL FIX 000 
INTERNAL FIX 000 
INTERNAL FIX 000 
INTERNAL FIX 001 
INTERNAL FIX 007 
INTERNAL FIX OO5 
INTERNAL FIX 002 
INTERNAL FIX 005 
INTERNAL FIX 000 
INTERNAL FIX 000 
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END OF PROGRAM 



DIAGNOSTIC MODE 



To run the diagnostic mode, perfoxm the following steps: 



1. Enter the following line to initiate the line test: 



: RUN DSTEST, DIAG 



If you are testing RFA, a :FILE command is required before 
initiating the DSTEST to direct the accessed file to the 
proper DS line. The file equation is: 



:FILE REMOTE ;DEV=dsdevice#DISC 
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System Verification 
2. Answer the following questions: 

.RFA or PTOP? 

Enter RFA for Remote File Access or enter PTOP for 
Program-to-Prograra testing* 

.REMOTE COMPUTER? 
Enter "3000" or "1000". 

.DSLINE? 

Enter the device class, logical device niimber, or node name 
#^ that was assigned to lODSO or lODSX during system 

conf igurat ion . 

.NUMBER OF PASSES? 

Enter the nxamber of actual transmissions desired, up to a 
maximum of 32767 (decimal). Zero (0) or a carriage return 
causes the test pattern to be transmitted once. 

.PATTERN? 

Enter an octal word to be transferred (the % sign must 
be entered) • 



^\ 



NOTE 



Illegal input causes the message 

INPUT ERROR 

to be printed. Enter a correct value 
or enter a carriage return to specify 
the default value 51177777. 



.BLOCKSIZE? 

Enter the desired blocksize of the transfer (<U096). If 
a value equal to or greater than U096 is entered , an 
error message will be printed. 
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. CONTINUE (Y/N)? 



Enter an affirmative response (Y) to return to the 
beginning of the option selection phase if you wish to 
repeat the cycle, or enter a negative response (N) to 
terminate the test. 



NORMAL MODE 

To run the normal mode, perform the following steps: 
1. Enter the following line to initiate the DSTEST: 
:RUN DSTEST 



In the normal mode, you are not required to select 
options; the default values are automatically used. 



2. Answer the following question: 



.DSLINE? 



Enter the device class, logical device number (decimal), or 
node name that was assigned to lODSO or lODSX during system 
conf igurat ion . 



NOTE 



The normal mode default is a 512 -word 
program-to-program transfer with all 
words containing %177777. 
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CONVENTIONS 
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To call an external procedure from ANS COBOL (COBOL/I), the 
parameters must be passed by word reference* This requirement 
effectively prevents the COBOL/I user from calling system-level 
intrinsics in general, and specifically, the DSN/DS Program-to- 
Program intrinsics. The following interface routines are provided 
to allow the ANS COBOL user access to the program-to-program 
communications capability. The user of COBOL IZ/3000 need not 
use these interface intrinsics, since the call-by-value capabili- 
ty can access the Program-to -Program intrinsics (as outlined in 
the COBOL/II Reference Manual). 



The parameters in the COBOL calling sequences 
following types: 



must be of the 



i^ 



If the parameter is an integer, it must be a COBOL picture 
through 9(U) or S9(3) computational, synchronized. 



9 



If the parameter is a character string, it must be defined as 
COBOL picture X(n) or A(n), where n is large enough for the 
required number of characters. 






In the following parameters, those not specifically 
characters will be assumed to be integers. 



defined as 



It is assumed that the user is already familiar with DSN/DS, in 
general, and the program-to-program intrinsics, specifically. 
Information regarding foxmal usage or content of the interface 
intrinsic parameters can be foimd in Section V. 
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COMMON PARAMETERS 

Parameters whose use is the same through all the procedures are: 

CCODE - integer (required) 

The condition code returned by the PTOP intrinsic. 
-1 = CCL 

= CCE 

1 = CCG 

DSNUM - integer (required) 

The number returned by CPOPEN, and which is required 

for all subsequent master PTOP calls. 

The number is always for slave programs. 

ITAG - A 20-word integer field (optional). 

TARGET - A character field used for reading or writing data 
(required) . 

TCOUNT - The number of words or bytes to be read or written 
(required) . 
Words are a positive integer; bytes are negative. 



INTERFACE INTRINSICS 
CPOPEN 

This procedure is the COBOL callable interface to POPEN. 

Calling Sequence: 

CALL "CPOPEN" USING CCODE, DSNUM, DSDEVICE, PROGNAME, 

ITAG, ENTRYNAME, PARM, FLAGS, 
STACKSIZE, DLSIZE, MAXDATA, 
BUFFSIZE 

Where: 

DSDEVICE is a character field containing the node name, device 
class, or logical device number of the desired DS line. 

PROGNAME is a character field containing the name (terminated 
by a space) of the remote slave program. 

ITAG is the 20-word integer field sent to and received from 
the remote program. 



'''^^^ 
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ENTRYNAME is the character field specifying the secondary entry 
^^ point (or spaces) where the remote program will begin 
^ execution. It is ignored if the slave system is an RTE system. 

FARM is an integer value to be placed in Q-U of the slave 
program. It is ignored if the slave system is an RTE system. 

FLAGS, STACKSIZE, DLSIZE, and HAXDATA are all HPE parameters 
used to specify slave program loading options. See Section V 
of this manual or the MPE Intrinsics Reference Manual for 
usage. It is ignored if the slave system is an RTE system. 

BUFFSIZE is an integer specifying the maximum number of words 
which will be transferred by any of the PTOP intrinsics. 

CPREAD 

This procedure is the COBOL callable interface to PREAD. 

Calling Sequence: 

CALL "C PREAD" USING CCODE, DSNUM, LENGTH, TARGET, 

TCOUNT, ITAG 



^\ 
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Vftiere: 

LENGTH is the actual number of words or bytes (depending on the 
value of TCOUNT) read into TARGET. (Required. ) 



CPWRITE 

This procedure is the COBOL callable interface to PWRITE. 
Calling Sequence: 

CALL "CPWRITE" USING CCODE, DSNUM, TARGET, TCOUNT, ITAG 

CPCONTROL 

This procedure is the COBOL callable interface to PCONTROL. 
Calling Sequence: 

CALL "CPCONTROL" USING CCODE, DSNUM, ITAG 
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CPCLOSE 

This procedure is the COBOL callable interface to PCLOSE. 
Calling Sequence: 

CALL "CPCLOSE" USING CCODE, DSNUM 

CGET 

This procedure is the COBOL callable interface to GET. 

Calling Sequence: 

CALL "CGET" USING CCODE, IFUN, ITAG, IL, lONUMBER 

Where: 

IFUN is the function number of the current pending PTOP 
operation . (Required . ) 

= An error occurred. This value is returned only when the 

condition code CCL is also returned. Issue a PCHECK 
intrinsic call (with a dsnum parameter of zero) to 
determine what happened. 

1 = POPEN request received. 

2 = PREAD request received. 

3 = PWRITE request received. 

k = PCONTROL request received. 

5 = This value is returned only when the condition code CCG 
is also returned. It indicates that a pending MPE File 
System I/O without wait request was completed (instead of 
the expected remote DSN/DS I/O request). ionumber 
contains the file number associated with the completed 
I/O request. 

IL is the number of words sent by a PWRITE or the number of 
words requested by a PREAD. 

lONUMBER is the file number of a non-DS file which completed 
an I/O without wait. 

CACCEPT 

This procedure is the COBOL callable interface to ACCEPT. 
Calling Sequence: 

CALL "CACCEPT" USING CCODE, ITAG» TARGET, TCOUNT 
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CREJECT 

This procedure is the COBOL callable interface to REJECT. 
Calling Sequence: 

CALL "CREJECT" USING CCODE, ITAG 

CPCHECK 

This procedure is the COBOL callable interface to FCHECK. 

Calling Sequence: 

CALL "CPCHECK" USING CCODE, DSNUM, ICODE 

Where: 

DSNUH is an integer. 

For a master program, this number is returned by the CPOPEN 

call. (Required.) 

For a slave program, this number is always 0. (Optional.) 

ICODE is an integer identifying the last error encountered. 
The error code meanings are given in Appendix B, under "DSN/DS 
Functional Errors". 

EXAMPLE 



The following example illustrates how two COBOL programs, 
residing on two HP 3000 computers, pass data back and forth. 
These two programs demonstrate and test the intrinsics available 
to the user of the COBOL Program-to-Program facility of DSN/DS. 
The Slave program must be entered on the remote system, compiled, 
and PREPed before the test. The PREPed file must then be made a 
permanent file. In this example, the MPE commands were: 

: COBOL COBOLSS (COBOL Slave Source) 
:PREP $OLDPASS, COBOLS 
:SAVE COBOLS 

The Master program must then be entered, compiled, PREPed, and 
Tvn on the local system. 

A brief outline of the test is as follows: 

1. The Master program opens the Slave program with CPOPEN. The 
ITAG array is filled with the value of the subscript of each 
array element, and the CPOPEN intrinsic is called. The Slave 
displays certain parameters involved in the opening. Then 
the Master also displays the value of the parameters used for 



F-5 



DSN/DS COBOL Interface 



3. 



opening the remote program • After each call is made to a 
COBOL intrinsic, the status of the call is checked in the 
STATUS -CK-RTN paragraph. 

The Master next tests the CPREAD intrinsic hy requesting that 
a message from the Slave be sent back* 

CPHRITE is tested by sending a message to the Slave* The 
Slave then displays the message as it was received to demon- 
strate the validity of the text. 



^ 



U. The CREJECT-TEST paragraph of the Master is used to test the 
CPREJECT intrinsic available to the Slave as well as the 
CPCONTROL intrinsic of the Master. The value lU is moved 
into the first element of ITAG and CPCONTROL is called. 
Within the paragraph that handles a call to CPCONTROL, the 
Slave tests this value and rejects the request. 



The master then calls CPCLOSE to 
before terminating itself. 



close the remote program 






The individual programs are shown on the following pages. 



Master PTOP Program 

001000$CONTROL USLINIT, SOURCE, MAP 
001100 IDENTIFICATION DIVISION. 
001200 PROGRAM-ID. MASTER-COBOL. 
001300 ENVIRONMENT DIVISION. 
OOlUOO DATA DIVISION. 

001600 WORKING-STORAGE SECTION. 



001700 
001800 
001900 
002000 
002100 
002200 
002300 
OO2UOO 
002500 
002600 
002700 
002800 



77 CCODE 
77 DSNUM 
77 PARAM 
77 FLAGS 
77 STACKSIZE 
77 DLSIZE 
77 MAXDATA 
77 BUFSIZE 
77 LGTH 
77 ICODE 
77 TCOUNT 
77 I 



002900 77 DATA-BUF 



PIC S99 
PIC S99 
PIC S99 
PIC S99 
PIC S9(U) 
PIC S9(U) 
PIC S9999 
PIC S999 
PIC S99 
PIC S99 
PIC S99 
PIC S99 
PIC X(66) 



COMP 
COMP 
COMP 
COMP 
COMP 
COMP 
COMP 
COMP 
COMP 
COMP 
COMP 
COMP 



0. 
0. 
0. 



VALUE 

VALUE 

VALUE 

VALUE 33. 

VALUE IS 

VALUE 

VALUE 

VALUE 

VALUE 
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IS 



-1. 
-1. 

IS 8000. 
IS 30U. 



0. 

VALUE 0. 
VALUE IS 33. 
VALUE 0. 
VALUE SPACES. 



003100 77 A-DOLLAR PIC X(12) VALUE 

PIC X(12) VALUE 

PIC X{26) VALUE 

PIC X(ll) VALUE 

PIC X(ll) VALUE 

PIC X(18) VALUE 

PIC X(12) VALUE 



A-DOLLAR 
003200 77 K-DOLLAR 
003300 77 M-DOLLAR 
OO3UOO 77 
003500 77 
003600 77 



0-DOLLAR 
R-DOLLAR 
S -DOLLAR 



003700 77 W-DOLLAR 



"« ACCEPT »". 

"## PCHECK ##". 

■•######### MASTER #########". 

"## POPEN ##". 

■•## PREAD ##". 

"## STATUS CHECK ##". 

"## PWRITE ##". 



^"^Sililv 
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r 
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003800 77 CO -DOLLAR 


PIC X(lU) 


VALUE 


"## PCONTROL ##' 


003900 77 C9 -DOLLAR 


PIC X(12) 


VALUE 


"## PCLOSE ##". 


OOUOOO 77 Dl -DOLLAR 


PIC XXXX 


VALUE 


"INDY". 


OOUlOO 77 EO -DOLLAR 


PIC XX 


VALUE 


II •• 

• 


OOU2OO 77 PO -DOLLAR 


PIC X(7) 


VALUE 


"COBOLS ". 


OOU3OO 77 RO -DOLLAR 


PIC X(12) 


VALUE 


"<< REJECT »". 



OOUllOO********************************************** 
001(300 01 ITAG- ARRAY. 

OOU6OO 02 ITAG-ARRAY-MEM PIC 99 OCCURS 20 TIMES. 
OOU7OO********************************************** 
OOU8OO* PROCEDURE DIVISION * 

OOU9OO********************************************** 
PROCEDURE DIVISION. 
DRIVER-PARA. 

PERFORM ISSUE-AN-OPEN. 
PERFORM ISSUE -A-READ. 
PERFORM ISSUE -A-WRITE. 
GO TO CREJECT-TEST. 
GO TO PCLOSE-CALL. 
ISSUE-AN-OPEN. 

DISPLAY M-DOLLAR. 
DISPLAY 0-DOLLAR. 
PERFORM LOOPI VARYING I FRCW 1 BY 1 UNTIL 

I IS GREATER THAN 20. 
DISPLAY " TAG TO BE SENT: ". 
DISPLAY ITAG-ARRAY. 

CALL "CPOPEN" USING CCODE, DSNUM, Dl -DOLLAR, P0-D0LLAR» 
ITAG-ARRAY, EO-DOLLAR, PARAH, FLAGS, STACKSIZE, DLSIZE, 
MAXDATA, BUFSIZE. 
DISPLAY 0-DOLLAR. 
DISPLAY " CCODE=", CCODE, " DSNUM=", DSNUM, 

" PARAM=", PARAM. 
DISPLAY " FLAGS=", FLAGS, " STACKSIZE=", STACKSIZE. 
DLSIZE=", DLSIZE, " MAXDATA=", MAXDATA. 
BUFSIZE=", BUFSIZE, " LGTH=", LGTH. 
PROGNAME=", PO-DOLLAR. 
ITAG-ARRAY RECEIVED: ". 
ITAG-ARRAY. 
STATUS-CK-RTN. 






003000 
005100 
003200 
005300 
OO3UOO 
005500 
005600 
005700 
005800 
005900 
006000 
006100 
006200 
006300 
OO6UOO 
006500 
006600 
006700 
006800 
006900 
007000 
007100 
007200 
007300 
OO7UOO 
007500 
007600 
007700 
007800 
007900 
008000 
008100 
008200 
008300 

ooSUoo 
008500 
008600 
008700 
008800 
008900 
009000 
009100 
009200 



DISPLAY 
DISPLAY 
DISPLAY 
DISPLAY 
DISPLAY 
PERFORM 
ISSUE -A-PREAD. 



DISPLAY R-DOLLAR. 

PERFORM LOOPI VARYING I FROM 1 BY 1 UNTIL 

I IS GREATER THAN 20. 
DISPLAY "ITAG TO BE SENT: ". 
DISPLAY ITAG-ARRAY. 
CALL "CPREAD" USING CCODE, DSNUM, LGTH, DATA-BUF, 

TCOUNT, ITAG-ARRAY. 
DI-SPLAY " CCODE=", CCODE, " DSNUM=", DSNUM, 

" LGTH=", LGTH. 
DISPLAY " DATA RECEIVED FROM SLAVE: ". 
DISPLAY DATA-BUF. 
DISPLAY " ITAG RECEIVED: ". 
DISPLAY ITAG-ARRAY. 
PERFORM STATUS-CK-RTN. 
ISSUE -A-WRITE. 
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009300 DISPLAY W-DOLLAR. 

OO9UOO PERFORM MULTIPLY-LOOP VARYING I FROM 1 BY 1 UNTIL 

009300 I IS GREATER THAN 20. 

009600 DISPLAY " ITAG TO BE SENT: ". 

009700 DISPLAY ITAG-ARRAY. 

009800 MOVE "THIS IS THE DATA FROM PWRITE TEST." TO DATA-BUF. 

009900 CALL "CPWRITE" USING CCODE, DSNUM, DATA-BUF, TCOUNT, 

010000 ITAG-ARRAY. 

010100 DISPLAY " CCODE=", CCODE, " DSNUM=", DSNUM. 

010200 DISPLAY " ITAG RECEIVED: ". 

010300 DISPLAY ITAG-ARRAY. 

010l»00 PERFORM STATUS-CK-RTN. 

010300 CREJECT-TEST. 

010600 DISPLAY CO-DOLLAR. 

010700 MOVE SPACES TO ITAG-ARRAY. 

010800 MOVE 1J» TO ITAG-ARRAY-MEM(l). 

010900 DISPLAY "ITAG TO BE SENT: ". 

011000 DISPLAY ITAG-ARRAY. 

011100 CALL "CPCONTROL" USING CCODE, DSNUM, ITAG-ARRAY. 

011200 PERFORM STATUS-CK-RTN. 

011300 STOP RUN. 

OllUOO LOOPI. 

011500 MOVE I TO ITAG-ARRAY-MEM(I). 

011600 MULTIPLY-LOOP. 

011700 MULTIPLY 2 BY ITAG-ARRAY-MEM(I) . 

011800 STATUS-CK-RTN. 

011900 IF CCODE IS LESS THAN ZERO GO TO 

012000 SOMETHING-WENT-WRONG. 

012100 IF CCODE IS GREATER THAN ZERO GO TO 

012200 REQUEST-REJECTED. 

012300 DISPLAY S-DOLLAR, "EVERYTHING OKAY". 

OI2UOO REQUEST-REJECTED. 

012300 DISPLAY S-DOLLAR, "REQUEST REJECTED BY SLAVE". 

012600 GO TO PCLOSE-CALL. 

012700 SOMETHING-WENT-WRONG. 

012800 DISPLAY S-DOLLAR, "CCL— SOMETHING IS WRONG". 

012900 CALL "CPCHECK" USING CCODE, DSNUM, ICODE. 

013000 DISPLAY K-DOLLAR, " CCODE=", CCODE, 

013100 " ICODE=", ICODE. 

013200 PCLOSE-CALL. 

013300 DISPLAY C9-D0LLAR. 

OI3UOO CALL "CPCLOSE" USING CCODE, DSNUM. 

013300 DISPLAY " CCODE=", CCODE, " DSNUM=", DSNUM. 

013600 STOP RUN. 



/^^ 
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Slave PTOP Program 



001000$CONTROL IX5LINIT, SOURCE 
001100 IDENTIFICATION DIVISION. 
001200 PROCSRAM-ID. SLAVE-COBOL. 
001300 ENVIRONMENT DIVISION. 
OOlUOO DATA DIVISION. 

001600 WORKING-STORAGE SECTION. 
001700 77 T PIC S99 USAGE CCMP. 
001800 77 I PIC S99 COUP VALUE 0. 



001900 77 CCODE 


PIC S99 


COMP VALUE 0. 


002000 77 IFUN 


PIC S9 


COMP VALUE 0. 


002100 77 IL 


PIC S99 


COMP VALUE 0. 


002200 77 lONUMBER 


PIC S99 


COMP VALUE 0. 


002300 77 ICODE 


PIC S99 


COMP VALUE 0. 


OO2UOO 77 DSNUM 


PIC S99 


COMP VALUE 0. 


002500******************************************** 


002600 77 C-DOLLAR 


PIC X(ll) 


VALUE "## CHECK ##". 


002700 77 G-DOLLAR 


PIC X.(9) 


VALUE "## GET ##". 


002800 77 A-DOLLAR 


PIC X(12) 


VALUE "## ACCEPT ##". 


002900 77 R-DOLLAR 


PIC X(12) 


VALUE "## REJECT ##". 


003000 77 S -DOLLAR 


PIC X(25) 


VALUE "######### SLAVE #########". 


003100******************************************** 


003200 77 00-DOLLAR 


PIC X(ll) 


VALUE "« POPEN »". 


003300 77 CO-DOLLAR 


PIC X{lh) 


VALUE "« PCONTROL »". 


003itOO 77 SO -DOLLAR 


PIC X(18) 


VALUE "## STATUS CHECK ##". 


003500 77 RO -DOLLAR 


PIC X(ll) 


VALUE "« PREAD »". 


003600 77 WO -DOLLAR 


PIC X(12) 


VALUE "« PWRITE »". 



003700******************************************** 

003800 01 DATA- ARRAY. 

003900 02 DATA- ARRAY-MEM PIC 99 OCCURS 33 TIMES. 

OOUOOO 01 ITAG- ARRAY. 

OOUlOO 02 ITAG-ARRAY-MEM PIC 99 OCCURS 20 TIMES. 

OOU2OO*************************************************** 

OOU3OO* PROCEDURE DIVISION * 

ooUUoo*************************************************** 

OOU5OO PROCEDURE DIVISION. 

OOU6OO START-OF -SLAVE. 

OOI47OO DISPLAY S -DOLLAR. 

OOU8OO CALL "CGET" USING CCODE, IFUN, ITAG-ARRAY, IL, lONUMBER. 

OOU9OO DISPLAY G-DOLLAR. 

005000 PERFORM PRINT-GET-PARAMS THROUGH CHECK -RETURN-CC. 

005100 IF CCODE IS NOT EQUAL TO ZERO GO TO CREJECT-PAR. 

005200 GO TO POPEN, PREAD, PWRITE, PCONTROL DEPENDING ON IFUN. 

005300 POPEN. 

OO5UOO DISPLAY S-DOLLAR. 

005500 DISPLAY OO-DOLLAR. 

005600 MOVE ZEROES TO ITAG-ARRAY. 

005700 GO TO CACCEPT-PAR. 

005800 PREAD. 

005900 DISPLAY S-DOLLAR. 

006000 DISPLAY RO-DOLLAR. 

006100 PERFORM LOOPl VARYING I FR<M 1 BY 1 UNTIL 

006200 I IS GREATER THAN 20. 
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006300 HERFORM INCREASE-LOOP VARYING T FRCM! 1 BY 1 UNTIL 

OO6I4OO T IS GREATER THAN IL. 

006500 GO TO CACCEPT-PAR. 

006600 LOOP?. 

006700 MOVE 7 TO ITAG-ARRAY-MEM(I). 

006800 LOOPl. 

006900 MOVE 1 TO ITAG-ARRAY-MEM(I). 

007000 L00P2. 

007100 MOVE 2 TO ITAG-ARRAY-MEMd). 

007200 INCREASE-LOOP. 

007300 MOVE T TO DATA- ARRAY-MEM (T) . 

OO7UOO PVJRITE. 

007500 DISPLAY S-DOLLAR. 

007600 DISPLAY WO-DOLLAR. 

007700 PERFORM L00P7 VARYING I FROM 1 BY 1 UNTIL 

007800 I IS GREATER THAN 20. 

007900 CACCEPT-PAR. 

008000 CALL "CACCEPT" USING CCODE, ITAG-ARRAY, DATA-ARRAY, IL. 

008100 DISPLAY A-DOLLAR. 

008200 PERFORM CHECK -RETURN-CC. 

008300 IF IFUN = 3 PERFORM PRINT-DATA. 

OO8UOO GO TO START-OF-SLAVE, 

008500 CREJECT-PAR. 

008600 CALL "CREJECT" USING CCODE, ITAG-ARRAY. 

008700 DISPLAY R-DOLLAR. 

008800 PERFORM CHECK-RETURN-CC. 

008900 GO TO START-OF-SLAVE. 

009000 PCONTROL. 

009100 DISPLAY CO-DOLLAR. 

009200 IF ITAG-ARRAY-MEM(l) = lit GO TO CREJECT-PAR. 

009300 PERFORM L00P2 VARYING I FROM 1 BY 1 UNTIL 

OO9UOO I IS GREATER THAN 20. 

009500 GO TO CACCEPT-PAR. 

009600 PRINT-DATA. 

009700 DISPLAY "DATA RECEIVED FROM THE MASTER: ". 

009800 DISPLAY DATA-ARRAY. 

009900 PRINT-GET-PARAMS. 

010000 DISPLAY " CCODE=", CCODE, " IFUN=", IFUN. " IL=", IL, 

010100 " IONUMBER=", lONUMBER. 

010200 biSPLAY "ITAG RECEIVED: ". 

010300 DISPLAY ITAG-ARRAY. 

OlOUOO CHECK-RETURN-CC. 

010500 IF CCODE IS NOT EQUAL TO ZERO 

010600 PERFORM SOMETHING-WENT-WRONG. 

010700 DISPLAY SO-DOLLAR, "EVERYTHING OKAY". 

010800 SCMETHING-WENT-WRONG. 

010900 CALL "CPCHECK" USING CCODE, DSNUH, ICODE. 

011000 DISPLAY C-DOLLAR. 

011100 DISPLAY " CCODE=", CCODE, " ICODE=", ICODE. 

011200 ERROR-EXIT. 

011300 DISPLAY "## SLAVE PROGRAM EXITING ##". 

OllUOO STOP RUN. 
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APPENDIX 



CONVENTIONS 



When parameters are specified in the CALL statement the BASIC/ 
3000 Interpreter (and compiled BASIC) sets up a parameter 
address table. The paraimeter address table consists of: 

m The niimber of parameters. 

e A code word for each parameter, specifying data type and 
dimensioning. 

e A reference pointer to each parameter. 

See Appendix F of the BASIC/3000 Interpreter Manual. 

Because the DSN/DS intrinsics are program-to-program, the 
BASIC/3000 slave must be a compiled and PREPed program. The 
master program may be either nmning on the Interpreter or man 
as a compiled prograon. 

It is assvuned that the user is already familiar with DSN/DS 

in general and the program-to-program intrinsics specifically. 

Information regarding formal usage or content of the interface 
intrinsic parameters can be found in Section V. 



COMMON PARAMETERS 

Parameters whose usage is the same throughout the procedures 
are: 

CCODE - integer (required) 

Condition code returned by the DSN/DS Program- 
to-Program intrinsic. 

-3 = not enough user stack for data transfer. 

-2 = CCL 

= CCE 

1 = CCG 
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DSNUM 



ITAG 



integer (required) 

The DSN/DS communication line number. 

(analagous to FOPEN file number) 

integer (optional) 
A 20 -word airray. 



Parameters - The BASIC-DSN/DS interface routines pack and 
unpack the data specified in the parameter 
lists of the master and the slave programs. 
The user must insure that the number of 
parameters specified on the master and the 
slave sides are the same and that the data 
types correspond. If the sending and receiving 
data types are not the same, the resulting 
data will be unpredictable. 



INTERFACE INTRINSICS 



BPOPEN 

This procedvire is the BASIC callable interface to POPEN. 
Calling Sequence: 



( 



CALL BPOPEN VCCODE*DSNUM,DSDEVICE,PROGNAHE 



Where: 

DSDEVICE 



PROGNAME 



ENTRYNAHE 



.ENTR^AME 
.0 



[(io^l 



[(: 

n,STACKSIZE( n,DL 
[,BUFFSIZE]]J]j]]]) 



DLSIZE) 



[|: 



ITAGl 
I 



FLAGS) 
1 



HAXDATAJ 



/^^^ 



- string (required). 

The DS line class, node name, or logical 
device number (string must have at least one 
trailing blank) * 

- string (required) . 

Name of remote slave program (terminated with 
a blank) , 

- string (optional) . 

Secondary entry point into the slave program 
(terminated with a blank). 
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PARAM - integer (optional). 

Value placed in Q-U of the slave program 
stack. 

FLAGS - MPE parameters used to control slave program 

STACKSIZE loading. See Section V of this manual or the 

DLSIZE MPE Intrinsics Reference Manual for usage. 
MAXDATA 

BUFSIZE - integer (optional) 

Maximum number of words per PTOP transfer. 



BPREAD 

This procedure is the BASIC interface routine to PREAD. 
Calling Sequence: 

CALL BPREAd(cCODE,DSNUM,LGTH j I [,param list] J 

Where: 

LOTH - integer (required) . 

Number of words received in transfer. 

parara list ::= param [ » param list ] 
param Any BASIC supported data tj^e (such as, 
STRING, INTEGER, REAL ARRAY) 



NOTE 



The BASIC interface routines: BPREAD, BPWRITE, and BACCEPT 
differ significantly from the PTOP intrinsics in the 
TARGET/TCOUNT vs. parameter list data schemes. The para- 
meter list allows the BASIC user to send and receive heter- 
ogeneous data items. A contiguous buffer is built on the 
User's stack for the transfers. 



BPWRITE 

This procedure is the BASIC callable interface to PWRITE. 
Calling sequence: 

CALL BPWRITE fcCODE ,DSNUM j [ [ ,param list] j 
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BPCONTROL 

This procedure is the BASIC interface routine to PCONTROL. 
Calling Sequence: 

CALL BPCONTROL (CCODE ,DSNUM [ , ITAG] ) 

BPCLOSE 

This procedxire is the BASIC interface routine to PCLOSE. 
Calling Sequence: 

CALL BPCLOSE (CCODE, DSMUM) 

BGET 

This procedure is the BASIC interface routine to GET. 

Calling Sequence: 

/ r,ITAG r,IL r^IONUMBERnnn \ 

CALL BGET f CCODE, IFUN 1 

Where: 

IFUN - integer (required) . 

Receives the function code from the request 
issued by the remote master program. (Refer 
to Section V for IFUN meanings • ) 

IL - integer (optional) . 

The number of words expected or sent on 
BPREAD or BPWRITE. 

lONUMBER - integer (optional) 

Valid if both CC0DE=1 and IFUN=5 

File number of completed non-DS I/O without 

wait. 

BACCEPT 

This is the BASIC callable interface routine to ACCEPT. 

Calling Sequence: 

/ r,ITAG-| \ 

CALL BACCEPT (CCODE, IFUN [.param list]! 
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BREJECT 

This is the BASIC callable interface routine to REJECT, 
Calling Sequence: 

CALL BREJECT(CCODE[»ITAG]) 



i^N 



BPCHECK 

This is the BASIC callable routine to PCHECK. 

Calling Sequence: 

CALL BPCHECK(CCODE,DSNUM,ICODE) 

Where: 

DSMUM - integer. 

For a master program, this number is returned by 
BPOPEN . (Required • ) 

For a slave program, this number is always 0. 
(Optional, ) 

ICODE - integer (required) • 

The number returned identifies the last error 
encountered. Refer to Appendix B, under the 
heading "DSN/DS Functional Errors", for meaning. 



EXAMPLES 



/^^^ 






Master PTOP Program 

MASTER 



1 


REM 


2 


REM 


3 


REM 


k REM 


5 


REM 


6 REM 


7 


REM 


8 


REM 


9 


REM 


10 


REM 


11 


REM 


12 


REM 


13 


REM 


lU REM 


15 


REM 


16 


REM 



MASTER PTOP PROGRAM 

THIS PROGRAM ISSUES A BPOPEN TO THE SALVE PROGRAM 
AND USES THE TAG FIELD TO SEND SUBTYPES FOR THE 
BREAD/BWRITE OPERATIONS. 

THE SUBFUNCTIONS ARE: 



WRITE: 



READ: 



1 - CHANGE NAME Nl $ TO N2$ 

2 - CHANGE ADDRESS TO Al$ FOR NAME N 

3 - ADD PERSON Nl$, Al$ 
k - DELETE PERSON Nl$ 

1 - SEND RECORD FOR NAME Nl$ 
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17 REM: 2 - SEND ALL RECORDS 

18 REM: THE TAG RETURN VALUES ARE: ^ 

19 REM: 1 - WRITE - OPERATION COMPLETE / 

20 REM: READ - BUFFER CONTAINS VALID DAT 

21 REM: - ON READ(2), MORE RECORDS COMING 

22 REM: ( CHANGES TO 1 ON LAST RECORD ) 

23 REM: -1 - RECORD NOT FOUND 

100 REM : ^^***********************^^***********^*^***^******^ 

101 REM: DATA DECLARATIONS 

102 REM: ************************************^********* 
105 REM: """BASIC PTOP INTRINSIC PARAMETERS::: 

110 INTEGER C,D,F,IO,L 

115 REM: C=CC; D=DSUM; F=FLAGS; IO=ICODE; L=LENGTH 

120 INTEGER II [20] 

125 REM: I1[*]=TAG FIELD 

130 DIM D0$[m,PO$[6] 

135 REM: DOS=DSLINE; P0$=REMOTE PROGRAM (SLAVE) 

150 REM: **" LOCAL VARIABLES *** 

155 DIM N1$[2G], N2$[20], Al$[20], R$Il+0] ^ 

160 REM: Nl$, N2$=NAMES; A1$»ADDRESS; R$-FULL RECORD (N1$,A1$) 

165 DIM C$[20], N$[22] 

170 REM: C$=USER COMMAND/TEXT LINE 

175 REM: N$=ENTER NAME MESSAGE 

200 REM : ***««*<***«tt*«***4>«**«**«<»********««tt4**»**«««*« 

201 REM: 

202 REM: START OF PROCESSING 

203 REM: ^.^ 
20U REM:"""""*"****"*"""""*"""""*""*"*"*"""""""""*"""* ^ 
205 REM « INITIALIZATION OF VALUES AND BPOPEN » 

210 D0$="PR2 " 

215 P0$=" SLAVE " 

220 F=32 

225 CALL BPOPEN (C,D,DO$,PO$,0,0,0,F) 

230 IF C=0 THEN GOTO 300 

235 PRINT "### ERROR ON BPOPEN ###" 

2UO GOSUB 1900 „^ 

2U5 STOP 1 

300 REM:*****************""*"*"**"******************** 

301 REM: WELCOME MESSAGE AND MENU 

302 REM: **********************^*********4(******4******* 



305 PRINT 
310 PRINT 
315 PRINT 
320 PRINT 
325 PRINT 
330 PRINT 
335 PRINT 
3UO PRINT 
3U5 PRINT 
350 PRINT 



MASTER AND SLAVE PTOP RUNNING" 



'»«« OPERATIONS MENU **«" 
N - NAME CHANGE" 
A - ADDRESS CHANGE" 
I - INSERT raRSON" 
D - DELETE PERSON" 
LN - LIST NAME AND ADDRESS" 
LA - LIST ALL NAMES AND ADDRESSES" 
EX - EXIT PROGRAM" 
UOO REM: """""""""""""""""""*""""""""""*************** 
UOl REM: NOW ASK FOR OPERATION 

U02 REM:*"""***********""""""""""""""""************** <"**'% 

U05 PRINT " " / 

UlO PRINT "ENTER OPERATION" 
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r 






^ 



Z^- 



U15 INPUT C$ 

U20 IF C$[1,1]="N" THEN GOTO 1000 

U25 IF C$[l,l]="A" THEN GOTO HOC 

U35 IF C$[l,li="l" THEN GOTO 1200 

UUO IF C$[1,1]="D" THEN GOTO 1300 

kk3 IF C$[1,2]="LN" THEN GOTO lUOO 

U50 IF C$[1,2]="LA" THEN GOTO I5OO 

U55 IF C$[1,2]="EX" THEN GOTO 2000 

U60 PRINT "***UNREC0GNIZED OPERATION ***" 

U65 GOTO 310 

1000 REM: ********************************************** 

1001 REM: NAME CHANGE 

1002 REM: *************4»<»«**4>***««««**««««4»<»««««*«««4»«« 

1005 PRINT N$ 

1010 LINPUT Nl$ 

1015 IF I1[1]<0 OR I1[1]>1 THEN GOTO I9OO 

1020 PRINT "ENTER NEW NAME" 

1025 LINPUT N2$ 

1030 Ll[l]=l 

1035 CALL BPWRITE (C»D,I1[*1 ,N1$,N2$) 

IOU5 GOSUB 1900 

1050 GOTO 1000 

1100 REM:********************************************* 

1101 REM: ADDRESS CHANGE 

1102 REM: ********************************************* 
1105 PRINT N$ 

1110 LINPUT 01$ 

1115 IF Nl$="" THEN GOTO UOO 

1120 PRINT "ENTER NEW ADDRESS" 

1125 LINPUT Al$ 

1130 II [1] =2 

1135 CALL BPWRITE(C,D,I1[*],N1$,A1$) 

111*5 GOSUB 1900 

1150 GOTO 1100 

1200 REM: ********************************************* 

1201 REM: INSET NAME 

1202 REM: ********************************************* 
1205 PRINT N$ 

1210 LINPUT Nl$ 

1215 IF Nl$="" THEN GOTO UOO 

1220 PRINT "ENTER ADDRESS" 

1225 LINPUT Al$ 

1230 II [1] =3 

1235 CALL BPWRITE (C,D, II [*],N1$,A1$" 

I2U5 GOSUB 1900 

1250 GOTO 1200 

1300 REM: ********************************************* 

1301 REM: DELETE PERSON 

1302 REM: ********************************************* 
1305 PEINR N$ 

1310 LINPUT Nl$ 

1315 IF Nl$="" THEN GOTO UOO 

1320 I1[1]=U 

1325 CALL BPWRITE(C,D,I1[*],N1$) 

1335 GOSUB 1900 
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I3U0 GOTO 1300 

lUOl REN: LIST NAME AND ADDRESS 1 

IU02 REM * ******^*****************************''^******** 

ll»05 PRINT N$ 

lUlO LINPUT Ml$ 

IU15 IF Nl$="" THEN GOTO 1*00 

ll»20 Il[l]=l 

IU25 CALL BPWRITE(C,D,I1[*],N1$,N1$) 

IU30 IF C=0 THEN CALL BPCONTROL(C,D,I1[*] ) 

IU35 IF C<>0 OR I1[1]<>1 THEN GOTO UOO 

lUUO L=-80 

ll*U5 CALL BPREAD(C,D,LI1[*],R$) 

IU50 GOSUB 1900 

IU55 PRINT R$ 

ll»60 GOTO lUOO 

1500 REM : ***^*************************************^***** 

1501 REM: LIST WHOLE LIST 

1502 KE)]:**********************************^***^******** ''''^ 

1505 L=-80 ' 

1510 H[l]=2 

1515 CALL BPREAD(C,D,L,I1[*],R$) 

1520 GOSUB 1900 

1525 PRINT R$ 

1530 IF I1[1]=0 THEN GOTO I5OO 

1535 GOTO UOO 

1900 REM : ********************************************** 

1901 REM: CONDITION CODE AND STATUS CHECK '^ 

1902 HEM:***^***^***************'*************'*********** 
1905 IF C>0 THEN GOTO 19^5 

1910 IF C<0 THEN GOTO I96O 

1913 CALL BPC0NTR0L(C,D,I1[*]) 

1915 IF Il(l]< OR I1[1]>1 THEN GOTO 1930 

1920 REM: ***EVERyTHING OKAY *** 

1925 RETURN 

1930 REM: »** BAD RECORD *** 

1935 PRINT "### NON-EXISTENT RECORD ###" ^ 

I9UO RETURN ^ 

I9U5 REM: •** CCG *** 

1950 PRINT. "### REQUEST REJECTED BY SLAVE ###" 

1955 RETURN 

i960 REM: •** CCL *** 

1965 CALL BPCHECK(C,D,IO) 

1970 PRINT "### PTOP ERROR:"; 10 ;"###" 

1975 RETURN 

2000 REM : ********************************************* 

2001 REM: EXIT 

2002 REM********************************************** 

2003 CALL BPCLOSE (C,D) 
2010 GOSUB 1900 

201^ END 
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SLAVEBF 


1 REM 


2 REM 


3 REM 
U REM 


5 REM 

6 REM 


7 REM 

8 REM 


9 REM 


10 REM 


100 REM 


101 REM 


102 REM 


103 REM 
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Slave PTOP Program 

############################################# 

SLAVE PTOP PROGRAM 

THIS PR0C5RAM ACEPTS DATA FROM THE MASTER 
AND ACCORDINGLY CHANGES, INSERTS OR DELETES 
ENTRIES. IT ALSO TRANSMITS NAME/ADDRESS 
RECORDS TO THE MASTER. 

DATA DECLARATIONS 

:•** BASIC PROP INTRINSIC PARAMETERS *** 

110 INTEGER C,F,L,IO,I,D 

115 REM: C=CC; F=FUNCTION; L=IL; 10=1/0; I=ICODE; D=DSNUM 

120 INTEGER II [20] 

125 REM: I1[*]=TAG FIELD 

130 REM:*** LOCAL VARIABLES *** 

135 DIM N1$[20],N2$[20],A1$[20] 

lUO REM: N1$,N2$=NAME; A1$=ADDRESS 

IU5 DIM N0$[50,20],A0$[50,20] 

150 REM LIST OF NAMES AND ADDRESSES 

155 INTEGER P,S 

160 REM: P=LAST RECORD POINTER; S=STATUS 

300 R£M: ********************************************* 

301 REM: START OF PROGRAM 

305 CALL BGET(C,F,I1[*]) 

310 G0SU6 1900 

315 GOSUB F OF 500,600,700,1100 

320 GOTO 300 

500 RKM* ********************************************* 

501 REM: BPOPEN 

502 RF-M ********************************************** 
505 CALL BACCEPT(C,F) 

510 GOSUB 1900 

515 FOR P=l TO 12 

520 READ NO$[P],A0$[P] 

525 NEXT P 

530 RETURN 

600 REM: ********************************************* 

601 REM: READ 

602 REM: ********************************************* 

605 IF II [11=2 THEN GOTO 65O 

606 REM:**** LIST SINGLE RECORD **** 
610 I1[1]=S=1 

615 CALL BACCEPT(C,F,I1[*],N0$[P0],A0$[P01) 

620 GOSUB 1900 

625 RETURN 

650 REM:**** LIST ALL RCORDS **** 

655 IF S<>0 THEN P0=0 
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660 S=0 

665 P0=P0+1 ^m^ 

670 IF PO=P THEN S=l ; 

675 I1[1]=S 

680 CALL BACCEPT(C,F,I1[*]«NO$[PO],AO$[PO]) 

683 GOSUB 1900 

690 RETURN 

701 REM: WRITE 

702 REM : *************************************^*********^ 

705 GOSUB II [1] OF 710,800,900,1000 

710 REM:**** NAME CHANGE **** 

713 CALL BACCFET(C,F,0,N1$,N2$} 

720 P0=0 

725 P9=P0+1 

730 IF N0$[P0]=N1$ THEN GOTO 750 

735 IF P0<> THEN GOTO 725 

7U0 S=-l 

7U5 RETURN ^"^ 

750 REM:**** FOUND NAME, NOW CHANGE IT **** Z 

755 N0$[P0]=N2$ 

760 S=l 

765 RETURN 

800 REM:**** ADDRESS CHANGE **** 

805 CALL BACCPET(C,F,0,N1$,A1$) 

810 GOSUB 1900 

815 P0=0 ^^ 

820 P0=P0+1 ^ 

825 IF N0$[P0]=N1$ THEN GOTO 81*5 

830 IF POoP THEN GOTO 820 

835 S=-l 

8UO RETURN 

8U5 REM:**** FOUND RECORD, NOW CHANGE ADDRESS **** 

850 RETURN 

8U5 REM:**** FOUND RECORD, NOW CHANGE ADDRESS **** 

850 A0$[P0]=A1$ 

855 S=l ^ 

860 RETURN 

900 REM:**** INSERT NAME **** 

905 CALL BACCEPT(C,F,0,N1$,A1$) 

910 GOSUB 1900 

915 IF P=50 THEN GOTO 9^5 

920 P=P+1 

925 N0$[P]=N1$ 

930 A0$[P]=A1$ 

935 S=l 

9U0 RETURN 

9U5 REM: **** LIST ALREADY FULL **** 

950 S=-l 

955 RETURN 
1000 REM:**** DELETE NAME **** 
1005 CALL BACCEPT(C,F,0,N1$) 

ioio GOSUB 1900 
1015 P0=0 
1020 P0=P0+1 
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1025 IF N0$[P0]=N1$ THEN GOTO IOU5 

1030 IF PQoP THEN GOTO 1020 

1035 S=-l 

lOUO RETURN 

IOU5 REM: **** FOUND IT, GET RID OP IT **** 

1050 NO$[POl=NO$[P] 

1055 PRINT "### SLAVE: PTOP ERROR:"; 10 ;"###" 

1060 RETURN 

1065 S=l 

1070 RETURN 

1100 REM: <***«**«************************************** 

1101 REM: BPCONTROL 

1102 REM : ********************************************* 

1105 I1[1]=S 

1110 CALL BACCEPT(C,F.I1[*]) 

1115 RETURN 

1900 p^ M************************************************ 

1901 REM: CONDITION CODE AND STATUS CHECK 

1902 RRM; *********************************************** 

1905 IF C>0 THEN GOTO 1925 

1910 IF C<0 THEN GOTO I9U0 

1915 REM:**** EVERYTHING OKAY **** 

1920 RETURN 

1925 REM:**** CCG **** 

1930 PRINT "### SLAVE: PT0P( CCG ) ###" 

1935 RETURN 

I9U0 REM:**** CCL **** 

19U5 1=0 

1950 CALL BPCHECK(C,I,IO) 

2000 REM: *********************************************** 

2001 REM: DATA SECTION 

2002 RE ************************************************ 
2005 DATA "CHRISTINE", "BRISTOL" 

2010 DATA "MEL", "CAMBRIGE" 

2015 DATA "CAROL", "PALO ALTO" 

2020 DATA "HISA, MISA & RICHIE" , "BRISTOL" 

2025 DATA "LISBET"," ZURICH" 

2030 DATA "JOHN", "BERKELEY" 

2035 DATA "CAROLYN", "ST. PAUL" 

20UO DATA "TODD", "SANTA CLARA" 

20U5 DATA "GARY", "SAN FRANCISCO" 
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APPENDIX 



H 



INTRODUCTION 



One of the features of the Network Configurator/Network Data Base 
is the ability to define the network configuration once, then 
store it away in an IMAGE/3000 data base, and have it automati- 
cally used whenever you use the network data base. In addition, 
you can later alter the configuration, and again store it away 
for future use. 

The data associated with the configuration is stored in an IMAGE 
data base in the PUB group of the SYS account. The data in the 
data base is manipulated by means of the Network Configuration 
Utility (NETCONF), which also resides in PUB, SYS. Although the 
Distributed Systems Network (DSN) products have read-only access 
to the data base so that they can determine the options selected 
for a particular line, only a network manager can change the 
network configuration. 
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ENVIRONMENT 
The Data Base 

The network configuration information is held in an IMAGE/3000 
data base in PUB. SYS* The data base consists of the following 
files: 

NETCON (Root File) 

NETCONOl 

NETCON02 

NETCON03 

NETCONOU 

NETCON05 

It will be necessary, since the configuration information is kept 

in a data base, to periodically make a backup copy onto magnetic ^»^ 

tape, for purposes of catastrophe recovery. It is recommended ^^% 

that the backup be taken each time the network configuration is 

changed, since the data base is only updated by the Network 

Configuration Utility (NETCONF). By doing this, a secure backup 

will be held of the latest network configuration. 

When backing up the data base, the DBSTORE operation must be done 
by a user of the PUB .SYS account. It is assumed that this user 
is also the network manager, as only the network manager would 
have access to the data base maintenance password. 

The data base must be ''RELEASED** using DBUTIL, so that all users 
(including DS/X.25) may have read access to the data base. Read 
access is necessary for the :DSLINE command to execute properly. 



The NETCONF Utility 

The DS Network Configuration Utility (NETCONF) resides in the PUB 
group of the SYS account. The purpose of NETCONF is to obtain 
from the network manager all of the information necessary to 
describe the network connection(s), the parameter values and 
options chosen at subscription time, and all information related 
to the way the connection(s) will be used. 

The NETCONF utility can be run by any user with read access to 
the data base. Only the data base creator has a write access to 
the data base, and it is assumed that the creator is the network 

manager • 
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USING NETCONF 



Data Base Organization 

The network configuration data is arranged into two sets (or 
tables) of information. 

The first set of data is known as the Remote Node (RN) table and 
contains the relationships between the destination logical node 
name 9 the logical device number (line identifier) > the X.25/X.21 
Public Data Network (PDN) address of the destination node 
(assigned by the PDN), and the remote node machine type* This 
table can have up to 20U8 entries, and it must have one entry for 
every relationship. For example, if node FRED has a PDN address 
of 123^ and can be reached across two separate DS lines, then 
there must be one entry for each line. 

Line Identifier 
Remote Node Name (LDEV Number) PDN Address 



Fred 51 123U 

Fred 52 123U 

Similarly, if two different nodes can be reached across the same 
line (as is probable when that line is connected to a PDN) then 
there will be an entry for each node. 

Line Identifier 
Remote Node Name (LDEV Number) PDN Address 



Fred 51 123U 

Joe 51 1235 

For DS/X.25» the destination logical node name cannot be 
configured on the system as a device class name. 

The second set of data is known as the Line Characteristics (LC) 
table and contains information pertaining to a particular line 
(logical device number). There must be an entry in this table 
for every line from this node and, unlike the RN table, each 
entry must be iinique. 

The relationship between the two tables is the line identifier 
(Idev number). For every line identifier referenced in the 
Remote Node table, there should be an entry in the LC table, and 
vice versa. NETCONF warns of any unsatisfied or illegal 
relationships when exiting; however, no attempt is made to insist 
on their being satisfied. 

There must be an entry in the data base for every node to which 
you want to send information and from which you want to receive 
information. If a node tries to access your computer via X.25 
and that node is not in the data base, the remote node will not 
be allowed access. 
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The Commands 

The Network Configuration Utility (NETCONF) has eight first-level 
commands : 

ADD 

CHECK 

DELETE 

EXIT 

HELP 

LIST 

PRINT 

UPDATE 



Any of these commands can be initiated after NETCONF has issued 
its identifying banner. The commands may (optionally) be 
abbreviated to one character, as any other input is ignored. The 
mode of NETCONF is conversational. After one of the commands has 
been specified, a series of prompts to the user is issued, as 
appropriate, for the relevant inputs. 

To terminate NETCONF command execution during an interactive 
session on HP terminals, press Control-Y (hold the Control key 
and press 7). This action terminates the current command and 
prompts for another first-level command. 

Refer to the information manual for your particular PDN for the 

recommended (or required) configuration parameters for X.2^ ^..^^ 

connections. ^j 



NOTE 



The following description of the interactive 
dialogue, that is initiated by these commands, 
is presented in a format similar to the one used 
for the MPE Configuration Dialogue in Appendix 
A. For additional clarification of this format, 
refer to page xiv, "Conventions Used In This 
Manual'*. 
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THE A[DD] COMMAND 



^^- 



/^^^ 



j^^^ 



This command is used to add a new entzy to either the Remote Node 
(RN) table or the Line Characteristic (LC) table. Note that only 
the creator of the data base can add entries to it. After 
specifying the ADD command, the dialogue proceeds as follows: 



Step Dialogue 

No. 

REMOTE NODE (RN) OR LINE CHARACTERISTICS (LC) TABLE? 

Enter one of the following replies: 

RN = VOien this is specified » you will be adding 
an entry to the Remote Node table, and the 
dialogue proceeds from there. Skip to Step 
1.0. 

LC = When this is specified, you will be adding 
an entry to the Line Characteristics table, 
and the dialogue proceeds from there. Skip 
to Step 2.0. 

return = When you reply with a carriage return, you 
will receive the following prompt: 

CONTINUING ADDING (YES OR NO)? 

YES = This response takes you back to the ADD 
prompt (Step 0) . 

NO = This response takes you out of the ADD 

command and prompts for another first -level 
command. 



INPUT MUST BE RN OR LC 

If this message appears, the response was not one of 
the above. You will be prompted again with the ADD 
prompt (Step 0). 
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Adding to the RN Table 

The following prompts cover the remote node characteristics. 



Step Dialogue 

No. 

1.0 REMOTE NODE NAME? 

Enter a logical node name. This name can be up to 
eight alphanumeric characters (the first being an 
alphabetic character), and it must be the name by which 
the destination node is to be referred when using the 
DSLINE command. 



NODE NAME SHOULD BE UP TO 8 ALPHANUMERIC CHARACTERS 

This message appears when the node name is greater than 
eight alphanumeric characters or when the first 
character is numeric. You will be prompted again for a 
logical node name (Step 1.0). 



1.1 REMOTE COMPUTER TYPE (HP3000 OR HPIOOO)? 

return = The default Remote Computer tjrpe (HP 3000) 
is used. 

HP3000 = The type of the Logical Node being 
addressed is an HP 3000. 

HPIOOO = The type of the Logical Node being 
addressed is an HP 1000. 



INPUT MUST BE HP3000 OR HPIOOO 

This message is received if the response was not one 
of the above. You will be prompted again for the 
Remote Computer type (Step 1.1). 



1.2 LOGICAL DEVICE NUMBER TO BE USED? 

Enter a line identifier (logical device number). This 
can be a nximeric value between 1 and 255 » said it must 
be the logical device number of the DS/X.25 line super- 
visor (lODSX). 
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Step Dialogue 

No. 

LOGICAL DEVICE SHOULD BE IN THE RANGE OF 1 TO 255 

This message api>ears when a line identifier that is not 
in the range of 1 to 255 has been specified. You will 
be prompted again for a Logical Device number (Step 
1.2). 

1.3 LINE TYPE (X25 OR X21)? 

Enter one of the following replies: 

return = The default (X25) line type is used. 

X25 = When this is specified » you will be 

prompted for the X.25 Remote Node Address. 
Skip to Step I.3.I. 

X21 = When this is specified, you will be 

prompted for an X.21 Remote Node Address. 
Skip to Step 1.3.2. 

INPUT MUST BE X25 OR X21 

This message appears when the response was not one of 
the above. You will be prompted again for the Line 
Type (Step 1.3). 

1.3.1 REMOTE X25 PDN ADDRESS? 

Enter one of the following replies: 

return = Either an X.25 network address is not 

needed because the connection will be across 
a point-to-point line, rather than a PDN; or 
the default network address will be used if 
the connection is across a PDN. (The 
default address is NULL). Skip to Step l.U. 

An X.25 PDN Network Address = This will be assigned 

by the relevant PDN across which you will be 
talking to the logical node. It should be a 
numeric address up to 15 digits in length, 
and it is the actual PDN address of the 
logical node. Skip to Step l.U. 
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Step Dialogue 

No. 

X23 ADDRESS SHOULD BE UP TO 13 DECIMAL DIGITS 

This message appears if the specified address is 
greater than 13 decimal digits or if a non-nvuneric 
network address was entered. You will be prompted 
again for the X.25 PDN address (Step 1.3.1). 



1.3.2 Z21 PDN ADDRESS? 

Enter one of the following replies: 

return = The default X.21 Address (all blanks) is 
used. 

An X.21 PDN Network Address = This address must be 
no more than 30 characters in length. 

X21 ADDRESS SHOULD BE UP TO 30 CHARACTERS 

This message appears if the address entered was larger 
than 30 characters. You will be prompted again for the 
X.21 PDN address (Step 1.3.2). 

l.k CONTINUING ADDING (YES OR NO)? 

YES = This will take you back to the ADD prompt 
(Step 0). 

NO or any input except YES = This will take you 
out of the ADD command and prompt for 
another first -level command. 

ADDITION COMPLETE 

This message appears when the Remote Node 
characteristics have been added to the Remote Node 
(RN) table. 

DUPLICATE ENTRY - NEW ENTRY NOT ADDED 

This message appears when there was already an entry in 
the Remote Node table with these relationships. 
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Step Dialogue 

No. 

DATA BASE IS FULL - NEW ENTRY NOT ADDED 

This message appears when the data base is full. To 
correct this situation, exit from NETCONF and enlarge 
the size of the IMAGE data base. 
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Adding to the LC Table 

The following prompts cover the general line characteristics. 

Step Dialogue 

No. 

2.0 LOGICAL DEVICE NUMBER? 

Enter a Line Identifier (logical device number). This 
can be a nxameric value between 1 and 233, and it must 
refer to the logical device number of the DS/X.25 line 
supervisor (lODSX). 

LOGICAL DEVICE SHOULD BE IN THE RANGE OF 1 TO 255 

This message appears if a line identifier not in the 
range 1 to 255 has been specified. You will be 
prompted again for a Logical Device nximber (Step 2.0). 

DUPLICATE ENTRY - NEW ENTRY NOT ADDED 

This message appears if there was already an entry in ^^^^^ 

the LC table with the same Logical Device number. ^ 

2.1 LINE TYPE ( X25 OR X21 )? 

Enter one of the following replies: 

return = The default protocol (X.25) is used. 

X25 = X.25 protocol will be used. Skip to Step 
2.1.1. 

X21 = X.21 protocol will be used. Skip to Step 
2.1.2. 

INPUT MUST BE X25 OR X21 

This message appears if the response was not one of the 
above. You will be prompted again for a Logical Device 
number (Step 2.1). 
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Step Dialogue 

^^ No- 

2.1.1 CONNECTION DIRECT OR VIA PDN? 






This prompt is issued only if the connection protocol 
is X.2^. Enter one of the following responses: 

return = The default connection type (DIRECT) is 
used. Skip to Step 2.1.1.1. 

DIRECT = The line connection will be point-to- 
point. Skip to Step 2.1.1.1. 

PDN = The line connection will be via Public 
Data Network. Skip to Step 2.1.1.2. 



INPUT MUST BE DIRECT OR PDN 

This message appears if the response was not one of the 
above. Tou will be prompted again for the connection 
type (Step 2.1.1). 



2.1.2 LINE IS LEASED OR SWITCHED? 

r^ This prompt is issued only if the connection protocol 

is X.21. Enter one of the following responses: 

return = The default LEASED is used (Step 2.2). 

LEASED = The line type is LEASED and the connection 
is point-to-point. Skip to Step 2.2. 



^^. 



SWITCHED = The line type is SWITCHED and the 

connection is via PDN. Skip to Step 2.1.3. 



INPUT MUST BE LEASED OR SWITCHED 

This message appears if the response was not one of the 
above. You will be prompted again for the line type 
(Step 2.1.2). 
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Step Dialogue 

No. 

2.1.1.1 MASTER (DCE) OR SLAVE (DTE) MODE? 

This prompt is issued only if the connection protocol 
is X.23 and line connection is DIRECT. Enter one of 
the following responses: 

DTE = The node is set up to act as a DTE. Kote 
that one end of the connection must be set 
up as the DTE, while on the destination 
node it must be set up as a DCE. Skip to 
Step 2.2. 

DCE = The node is set up to act as a DCE. Skip 
to Step 2.2. 

INPUT MUST BE DCE OR DTE 

This message appears if the response was not one of the 
above. You will be prompted again for the DTE or DCE 
mode (Step 2.1.1.1). 



NOTE 



When the connection protocol is X.25 and line ^_^ 

connection is DIRECT, the following local X.25 ^^ 

addresses are used: 

Master (DCE) mode -- Local X.25 address is 9 
Slave (DTE) mode — Local X.25 address is 8 

2.1.1.2 LOCAL X25 PDN ADDRESS? 

This prompt is issued only if the connection protocol 
is X.25 and line connection is via PDN. Enter one of 
the following responses: 

return = The default local address of all zeroes 
is used. 

Local X25 PDN address = This is the actual local 

address (from address) assigned by PDN at 
subscription time. It should be a numeric 
address up to 15 digits in length. 

X25 ADDRESS SHOULD BE UP TO 15 DECIMAL DIGITS 

This message appears if the specified address is 
greater than 15 decimal digits or if a non-numeric 
network address has been specified. You will be 
prompted again for the local X.25 PDN address (Step 
2.1.1.2). 
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Step Dialogue 

No. 

2.1.3 NAME OF PDN? 

This prompt is issued only if the connection protocol 
is X.21 and the line is SWITCHED, or if the connection 
protocol is X.25 and the line connection is via PDN. 
Enter one of the following responses: 

Name of PDN = The PDN name must be no more than 
eight alphanumeric characters. 

return = The default PDN name of all blanks is 
used. 

PDN NAME SHOULD BE UP TO 8 ALPHANUMERIC CHARACTERS 

This message appears if the PDN name is greater than 
eight alphanumeric characters. You will be prompted 
again for a PDN name (Step 2.1.3). 

2.2 PRIMARY REMOTE NODE TO BE CONNECTED TO ON THIS LINE? 

Reply by entering the Remote Node Name. This must cor- 
respond to one of the remote node names associated with 
this line identifier in the RN table. VDien a :DSLINE 
command is issued with a line identifier instead of a 
node name 9 it might not be unique. In such a case, the 
node to Tdiich the connection will be established is the 
one identified here. 



r 



NOTE 



DS/X.23 users are encouraged to always use a 
node name in the :DSLINE command instead of a 
line identifier. 



NODE NAME SHOULD BE UP TO 8 ALPHANUMERIC CHARACTERS 

This message appears if the node name is greater than 
eight alphanumeric characters or if the first character 
was numeric. You will be prompted again for Primary 
Node name (Step 2.2). 
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The following prompts ^ covering low- level (Level 2) 
characteristics, are issued only if the connection protocol is 
X,25. 



NOTE 



For Direct Connect DS/X.25 lines, all Level 2 
parameters must be configured exactly the same 
as the corresponding Level 3 parameters. 



Step Dialogue 

No. 

2,3 RESPONSE TIMER (MILLISECONDS) ? 

Enter one of the following replies: 

return = The default value of 200 is used. 

Response Timer = This value must be an integer in 

the range of 1 to 9999, and it specifies the 
period at the end of which retransmission of 
a frame can be indicated. (In the case of a 
PDN connection, this is usually dictated by 
that PDN.) 

RESPONSE TIMER SHOULD BE IN THE RANGE 1 TO 9999 

This message appears if your reply was either non- 
niuneric or not in the range of 1 to 9999 • You will be 
prompted again for Response Timer (Step 2.3). 

2.I4 RETRY COUNT (1..255) ? 

Enter one of the following replies: 

return = The default value of 8 is used. 

Retry Count = This must be a numeric value in the 

range of 1 to 2^^. It specifies the maximum 
number of retransmissions of frames that 
will be attempted following the running out 
of the response timer. (In the case of a 
PDN connection, this is usually dictated by 
that PDN.) 

RETRY COUNT SHOULD BE IN THE RANGE 1 TO 255 

This message appears if your response was either non- 
nxameric or not in the range of 1 to 255. You will be 
prompted again for Retry Count (Step 2.U). 
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Step Dialogue 

No. 

2.5 WINDOW SIZE (FRAMES) ? 

Enter one of the following replies: 

return = The default value of 2 is used. 

Window size ^ Window size specifies the naxiroxun 

nxunber of sequentially numbered I -frames 
that a DTE/DCE may have outstanding 
(unacknowledged) at any given time. The 
minimum value of this parameter is 1» and 
the maximum value is 7* (In the case of a 
PDN connection, this is usually dictated by 
that PDN.) 
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For optimum performance, tests have shown that both 
Level 2 and Level 3 window sizes should be 7* 



WINDOW SIZE SHOULD BE IN THE RANGE 1 TO 7 

This message appears if your response was either non- 
numeric or not in the range 1 to 7* You will be 
prompted again for Packet Size (Step 2.3)* 



The following prompts cover the upper-level (Level 3) 
characteristics • 



2.6 LOW VC NUMBER (0..U095) ? 

Enter one of the following replies: 

return = The default value of is assigned as the 
low virtual circuit number. 

Virtual Circuit Number = This must be an integer in 
the range of to U095» It represents the 
low end of the virtual circuit identifica- 
tion numbers. (In the case of a PDN con- 
nection, this is usually dictated by that 
PDN.) 

LOW VC SHOULD BE IN THE RANGE OF TO U095 

This message appears if your response was not numeric 
or if it was not in the range of to U095» You will 
be prompted again for the Low VC Number (Step 2.6). 
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Step Dialogue 

No. 

2.7 HIGH VC NUMBER (0..U095) ? 

Enter one of the following replies: 

return = The default value of the Low Virtual 

Circuit Nuinl)er + 255 is assigned as the high 
virtual circuit number. 

Virtual Circuit Number = This must be an integer in 
the range of to U095» dnd it represents 
the high end of the virtual circuit identi- 
fication numbers. It has to be greater than 
the low virtual circuit number, but no more 
than 255 above that value. (In the case of 
a PDN connection, this is usually dictated ^^^^ 

by that PDN.) ^ 

HIGH VC SHOULD BE IN THE RANGE nnnn TO mmmm 

This message appears if your response was non-numeric, 

was not in the range of to U095f was less than the 

low virtual circuit number, or was greater than the sum 

of the low virtual circuit number + 255 • You will be ^.^^ 

prompted again for the high virtual circuit niunber j 

(Step 2.7). 

2.8 PACKET SIZE (32..1021*) ? 

Enter one of the following replies: 

return = The default packet size (128 bytes) is 
used. 

Packet Size = This must be a numeric value in the 
range of 32 to 102U. It represents the 
packet size (in bytes) that will be used 
across this connection. (In the case of a 
PDN connection, this is usually dictated by 
that PDN.) 

PACKET SIZE SHOULD BE IN THE RANGE 32 TO 102U 

This message appears if your response was either non- 
numeric or not in the range of 32 to 102^. You will 
be prompted again for the packet size (Step 2.8). 
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^^ 



Step Dialogue 

No. 

2.9 MODULO COUNT (8 OR 128) ? 

Enter one of the following replies: 

return = The default of 8 is used. 

Modulo Count = This is the counting scheme used 

for packets across this connection. (In 
the case of a Public Data Network (PDN) 
connection* This is usually dictated by 
that PDN.) 



NOTE 



/^^ 
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The modulo count has no major effect on performance. 

2.10 WINDOW SIZE (PACKETS) ? 

Enter one of the following replies: 

return = The default window size (2 packets) is 
used. 

Window Size = This must be a numeric value in the 

range of 1 to 7 (for a modulo count of 8) or 
in the range of 1 to 1^ (for a modulo count 
of 128). It represents the window size (in 
packets) that will be used across this 
connection. (In the case of a Public Data 
Network (PDN) connection, this is usually 
dictated by that PDN.) 



NOTE 



For optimum performance, tests have shown that 
both Level 2 and Level 3 window sizes should 
be 7 if a modulo count of 8 is being used at 
Level 3* For a modulo count of 128, any window 
size greater than 7 has approximately the same 
performance . 



WINDOW SIZE SHOULD BE IN THE RANGE 1 TO 7 

This message appears if your response was either non- 
numeric or not in the range of 1 to 7 when a modulo 
coimt of 8 is being used. 
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Step Dialogue 

No. 

WINDOW SIZE SHOULD BE IN THE RANGE 1 TO 15 

This message appears if your response was either non- 
nximeric or not in the range of 1 to 13 ^en a modulo 
count of 128 is being used. After receiving either of 
these messages, you will be prompted again for the 
window size (Step 2.10). 



2,11 CONTINUING ADDING (YES OR NO)? 

YES = This will take you back to the ADD prompt 
(Step 0). 

NO or any input except YES = This will take you 
out of the ADD command and prompt for 
another first-level command. 



ADDITION COMPLETE 

This message appears when the line characteristics have 
been added to the Line Characteristics (LC) table. 



DATA BASE IS FULL - NEW ENTRY NOT ADDED 

This message appears when the data base is full. To 
correct this situation, exit from NETCONF and enlarge 
the size of the IMAGE data base. 



^^^^^ 
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CHECK 

THE C[HECK] COMMAND 



This command is used to check the relationships , and report any 
discrepancies » between the RN and LC tables* Three basic checks 
are performed; and since they are always done/ there is no 
dialogue following the command* 

The first check scans the Remote Node table. For every Line 
Identifier (Ldev number) that is used, it checks that there is a 
corresponding entry in the LC table. If there is no such entry , 
the following warning is printed: 

Ldev nnn is not entered in the LC table 

The second check scans the LC table. For each entry, it checks 
that the primary node name specified for a logical device has a 
corresponding entry in the Remote Node table. If there is no 
such entry, the following warning is printed: 

aaaaaaaa ( using LDEV nnn ) is not entered 
in the RN table 

The third check scans the LC table. For each entry, it checks 
that all RN entries with the same LDEV have the same line type as 
the LC entry. For each entry in the RN table where the line 
types do not match, the following warning is printed: 



^ aaaaaa (LDEV nnn) line type differs from LC line tjrpe 
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THE D[ELETE] COMMAND 

This command is used to remove data entries from the RN table or 
the LC table. Note that only the creator of the data base can 
delete entries. After specifying the DELETE command » the 
dialogue proceeds as follows: 

Step Dialogue 

No. 

REMOTE NODE (RN) OR LINE CHARACTERISTICS (LC) TABLE? 

Enter one of the following replies: 

RN = When this is specified, you will be 

deleting an entry from the Remote Node 

table » and the dialogue proceeds from there. "^"^ 

Skip to Step 1.0. 

LC = When this is specified, you will be delet- 
ing an entry from the Line Characteristics 
table, and the dialogue proceeds from there. 
Skip to Step 2.0. 

return = When you reply with a carriage return, you ^^.^^^^ 

will receive the following prompt: ^^j 

CONTINUING DELETING (YES OR NO)? 

YES = This response takes you back to the DELETE 
prompt (Step 0). 

NO = This response takes you out of the DELETE 

command and prompts for another first-level 
command. 



INPUT MUST BE RN OR LC 

If this message appears, the response was not one of 
the above. You will be prompted again with the DELETE 
prompt (Step 0). 
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Deleting from the RN Table 

The following prompts cover the remote node characteristics. 

Step Dialogue 

No. 

1.0 REMOTE NODE NAME? 

Enter a remote node name. This name can be up to eight 
alphanumeric characters (the first being an alphabetic 
character), and it must refer to the same name by which 
the destination node is to be referred when using the 
DSLINE command. 

NODE NAME SHOULD BE UP TO 8 ALPHANUMERIC CHARACTERS 

This message appears ^dien the node name is greater than 
eight alphanumeric characters or when the first 
character is numeric. You will be prompted again for a 
logical node name (Step 1.0). 

NO SUCH ENTRY IN THE RN TABLE 

This message appears if a legal remote node name has 
been specified, but there is no entry in the RN table 
for it. You will be prompted for another first-level 
command. 

A valid remote node name has been specified, and you are about to 
^^ delete an entry or entries from the RN table. NETCONF also 

^^ prompts to enable you to delete a corresponding entry from the LC 

^ table. Since there can be multiple entries in the RN table for 

the name you have specified, NETCONF repeats the following 
sequence ot prompts until all entries have been covered; where- 
upon you will be prompted for a first -level command. 



#^ 
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Step Dialogue 

No. 

RN TABLE ENTRT WITH NODE NAME = xxxxxxxx USING LDEV = nnn 

CONFIRM DELETION (YES OR NO) ? 

Enter one of the following replies: 

return = When you reply with a carriage re turn , 
this message appears: 

ENTRY NOT DELETED 

The delete is not confirmed « and processing 
proceeds. If there are further entries in 
the RN table satisfying the Remote Node Name 
specified I this step will be repeated; 
otherwise, you will be prompted for a first- 
level command. 

NO or any input except YES = This reply results 
in the message: 

ENTRY NOT DELETED 

The delete is not confirmed » and processing 
proceeds. If there are further entries in 
the RN table satisfying the Remote Node Name 
specified, this step will be repeated; 
otherwise, you will be prompted for a first- 
level command. 

YES = This reply results in the message: 

ENTRY HAS BEEN DELETED 

The entry has been deleted from the RN 
table, and processing proceeds. If there is 
an LC entry corresponding to this entry 
(having the same logical device number), 
processing proceeds to the next step; if 
there is not a corresponding LC entry and 
there are further entries in the RN table 
satisfying the remote node name specified, 
this step will be repeated. Otherwise, you 
will be prompted for a first-level command. 
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Step Dialogue 

No. 

ASSOCIATED LC TABLE ENTRY WITH LDEV = nnn 

CONFIRM DELETION (YES OR NO) ? 

Enter one of the following replies: 

return = The delete will not be confirmed, and 

processing proceeds. If there are further 
entries in the RN table satisfying the 
remote node name specified, the previous 
prompt is repeated; if there are not, you 
will be prompted for a first -level command. 

NO ^^ any input except YES = The delete will not 

rbe confirmed, and processing proceeds. If 
there are further entries in the RN table 
satisfying the logical node name specified, 
the previous prompt is repeated; if there 
are not, you will be prompted for a first- 
level command. 
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YES = The entry is deleted from the LC table, 
and processing proceeds. If there are 
further entries in the RN table satisfying 
the logical node name specified, the 
previous prompt is repeated; if there are 
not, you will be prompted for a first-level 
command. 



#^ 
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Deleting from the LC Table 



step Dialogue 

No. 

2.0 LOGICAL DEVICE NUMBER? 

Enter a line Identifier (logical device number). This 
can be a numeric value between 1 and 235% s^d it roust 
refer to the logical device number of the DS/X.25 line 
supervisor (lODSX). 



LOGICAL DEVICE SHOULD BE IN THE RANGE OF 1 TO 255 

This message appears if a line identifier not in the 
range 1 to 255 b^&s been specified. Tou will be 
prompted again for a logical device number (Step 2.0). 



NO SUCH ENTRT IN THE RN TABLE 

This message appears if a legal line identifier was 
specified, but there is no entry in the LC table for 
it. You will be prompted for another first -level 
command. 



A valid logical device number has been specified , and you are 
about to delete an entry from the LC table. NETCONF also prompts 
to enable you to delete a corresponding entry or entries from the 
RN table. 



LC TABLE ENTRY WITH LOGICAL DEVICE NUMBER = nnn 

CONFIRM DELETION (YES OR NO) ? 

Enter one of the following replies: 

return = The delete is not confirmed, and you will 
be prompted for a first -level command. 

NO or any input except YES = The delete will not 

be confirmed, and processing proceeds. You 
will be prompted for a first-level command. 



/^^'^ 



H-2U 



DELETE 



^#*^ 
P 



/^^ 



Step Dialogue 

No. 

YES = The entry is deleted from the LC table, 
and processing proceeds. If there is an 
entry (or entries) in the RN table corres- 
ponding to this line identifier, processing 
proceeds to the next step; if not, you will 
be prompted for a first -level command. 



ASSOCIATE RM TABLE ENTRIES USING LDEV = nnn 

CONFIRM DELETION (YES OR NO) ? 

Enter one of the following replies: 

return = The delete is not confirmed, and you will 
be prompted for a first -level command. 

NO or any input except YES = The delete is not 

confirmed, and you will be prompted for a 
first-level command. 

YES = All entries in the RN table that use this 

line identifier (LDEV) are deleted, and you 
will be prompted for a first -level command. 



^^ 
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EXIT 

THE E[XIT] COMMAND 

This conmand is used to terminate the execution of the Network 
Configurator. Prior to termination, a call is automatically made 
to the CHECK command , and any discrepancies in the relationship 
between the RN and LC tables are printed. If there are no dis- 
crepancies , NETCONF terminates. If there are discrepancies, pro- 
cessing proceeds as follows: 

Step Dialogue 

No. 

IS IT OK TO EXIT ? 

Enter one of the following replies: 

return = You will be prompted for a first-level ^^^^ 

command. / 

NO or any input except YES = You will be prompted 
for a first -level command. 

YES = NETCONF terminates execution. 



.'^'^^ 






'"^ 



H-26 



^^. 



HELP 

THE H[ELP] COMMAND 



This command provides a basic description of each of the commands 
in the Network Configuration Utility (NETCONF) command set. 
Since the commands are only being described, there is no follow- 
up dialogue in the HELP command. Only a very basic description 
of functionality is provided by the HELP command; so idien more 
detail is required » refer to the descriptions presented in this 
manual. 
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THE L[IST] COMMAND 



This command provides a display on your terminal screen of the 
current content of the network configuration data base. The data 
is arranged into the Remote Node (RN) and Line Characteristics 
(LC) tables ^ under the following headings: 



Remote Node Table 



Node 
Name 



xxxxxxxx 
xxxxxxxx 



System 
Type 



HP3000 
HPIOOO 



Ldev 
No 



nnn 
nnn 



Line Type 



X25 
X21 



Remote 
PDN Address /Phone Number 



xmnnnnnnnnnnnn 
xxxxxxxxxxxxxxxxxxxxxxxx 



,/««^ 







Line Characteristics 


Table 1 


j Ldev 
1 No 


Line Type 


Connect 
Method 


DCE/DTE i 


Remote Primary Node | 


1 nnn 
1 • 
1 nnn 


1 X21 
X25 


xxxxxxxx 

• 

xxxxxxxx 


DCE 1 

• 1 

DTE 1 


xxxxxxxx 1 

• 1 

xxxxxxxx 1 



^ 



H-28 



LIST 








1 
Line Characteristics Table (X25) | 

1 


1 Ldev 


Local 
X2^ Address 


1 1 1 

Level 2 | Level 3 1 


1 No 


II 

Tl 1 Retry! Win- (Low iHigh j Packet j Win- j Mod | 

Timer! Count jdow !VC |VC ! Size !dow |Cnt! 

! 1 ! 1 1 III 


1 mm 


zuinn • . . nnn 


! 1 ! 1 1 II! 

xmzin 1 nnn | n |nnnn|nnnn | nnnn |nnnn|nnn| 

I 1 1 1 1 III 



NOTE 



The Line Characteristics Table (X25) will not be printed 
unless there are entries in the LC table that have the 
"X25*' line tjrpe. If there are any X.25-related entries 
in the general LC table, then the LC (X25) table will 
contain entries only for those X*25-related LDEVs. 






Since all of the information is automatically provided upon 
specifying the LIST command, there is no following dialogue. 



i^^. 



H-29 



PRINT 

THE P[RINT] COMMAND 



The PRINT command lists the current contents of the Remote Node 
(RN) and Line Characteristics (LC) tables to a line printer and 
validates the node name and logical device relationship between 
the two tables. It executes the LIST and CHECK commands , with 
the output device being a line printer rather than the $STDLIST. 
The formal designator is NETLIST and the default device name is 
LP. FILE equations are permitted, which enables you to specify a 
file or device to which the data base contents are to be printed. 



^ 
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UPDATE 

THE U[PDATE] COMMAND 

This conunand is used to update entries in the Remote Node (RN) or 
Line Characteristics (LC) table which already exist • Note that 
only the creator of the data base can update the data base. 
After specifying the UPDATE conrniand, the dialogue proceeds as 
follows : 

Step Dialogue 

No. 

REMOTE NODE (RN) OR LINE CHARACTERISTICS (LC) TABLE? 

Enter one of the following replies: 

RN - When this is specified « you will be adding 
an entry to the Remote Node table, and the 
dialogue proceeds from there. Skip to Step 
1.0. 

LC = When this is specified, you will be adding 
an entry to the Line Characteristics table, 
and the dialogue proceeds from there. Skip 
to Step 2.0. 

return = When you reply with a carriage return, you 
will receive the following prompt: 

CONTINUING UPDATING (YES OR NO)? 

YES = This response takes you back to the UPDATE 
prompt (Step 0) . 

NO = This response takes you out of the UPDATE 

command and prompts for another first -level 
command. 

INPUT MUST BE RN OR LC 

If this message appears, the response was not one of 
the above. You will be prompted again with the UPDATE 
prompt (Step 0) . 
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Updating the RN Table ^^ 

The following prompts cover the remote node characteristics. 

Step Dialogue 

No. 

1.0 REMOTE NODE NAME? 

Enter a remote node name. This name can be up to eight 
alphanumeric characters (the first being an alphabetic 
character) ^ and it must be the name by which the desti- 
nation node is to be referred when using the DSLINE 
command. 

NODE NAME SHOULD BE UP TO 8 ALPHANUMERIC CHARACTERS ^ 

This message appears when the node name is greater than 
eight alphanumeric characters or when the first 
character is numeric. You will be prompted again for a 
remote node name (Step 1.0). 

NO SUCH ENTRY IN THE RN TABLE 

This message appears if a legal remote node name was 
specified, but there is no entry in the RN table for 
it. You will be prompted for another first -level 
command. 



Prior to issuing any prompts, NETCONF first prints all entries in 
the RN table that qualify with the remote node name specified. 
Since there can be multiple entries in the RN table for the 
remote node name that you have specified, you will be prompted 
for the logical device number associated with the remote node 
name. 



1.2 LOGICAL DEVICE NUMBER ? 

Enter one of the following replies: 

return = You will be prompted again for an LDEV. 

A Line Identifier (Logical Device Number) = This 

must be the line identifier that specifies 
which of the entries in the RN table for a 
particular logical node you wish to update. 



/^ 
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Step Dialogue 

No. 

LOGICAL DEVICE NUMBER SHOULD BE IN THE RANGE OF 1 TO 255 

This message appears Tdien a non-numeric line identifi- 
er ^ or a line identifier that is not in the range of 1 
to 255 f has been specified. You will be prompted again 
for a logical device number (Step 1.2). 



NO SUCH ENTRY IN THE RN TABLE 

This message appears if a valid line identifier was 
specified, but none of the qualifying NLA entries uses 
this line identification. You will be prompted for a 
first -level command. 



All other prompts « responses , and error messages are the same as 
for the ADD command. For each variable in the entry, the current 
value is printed, followed by a prompt for a new value. A 
carriage return maintains the current value. 



j^™^ 
fP^ 
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UPDATE 

Updating the LC Table 



/^ 



step Dialogue 

No. 

2.0 LOGICAL DEVICE NUMBER? 

Enter a line identifier (logical device number). This 
can be a nximeric value between 1 and 255^ and it must 
refer to the logical device number of the DS/X.25 line 
supervisor (lODSX). 

LOGICAL DEVICE SHOULD BE IN THE RANGE 1 TO 255 

This message appears if a line identifier not in the ^^ 

range of 1 to 255 has been specified. You will be 
prompted again for a logical device number (Step 2.0). 

NO SUCH ENTRY IN LC TABLE 

This message appears if a legal line identifier was 

specified , but there is no entry in the LC table for ^.^ 

it. You will be prompted for another first-level ^^7 

command. 

This procedure follows that of adding to the LC table. For 
each variable in the entry, the current value is printed, 
followed by a prompt for a new value. A carriage return 
maintains the current value. All other prompts, responses, and 
error messages are the same as for the ADD command. 
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USING X.25/X.29 CAPABILITIES 



APPENDIX 
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The DS/X.23 capability of DSN/DS is an enhancement to the DSN/DS 
subsystem that permits system-to-system commiinication via an X.25 
Public Data Network (PDN). This enhancement is not a separate 
product, but rather it is an additional capability of DSN/DS to 
provide support for the X.25 protocol (an international standard 
for connection to PDNs). With this capability, it is now possi- 
ble to connect to multiple remote systems over a single X.23 link 
to a PDN. 



In conjunction with the DS/X.25 capability, DSN/DS also provides 
support for the X,29 protocol (an international standard for 
connecting asynchronous character-mode terminals to the system 
through an X^25 Public Data Network). With the X.25 and X.29 
capabilities, you can run a session on a remote HP 3000 computer 
from your terminal by calling through a Packet Assembler/ 
Disassembler (PAD) on a Public Data Network. This feature allows 
you to benefit from the lower communication cost afforded by the 
use of a PDN rather than dialing a long distance call directly to 
the computer. 



^^. 



X.25 SYSTEM-TO-SYSTEM COMMUNICATION 



As a DS/X.25 user, you can establish a maximum of eight remote 
sessions across one X.25 link to a Public Data Network (PDN). 
These eight remote sessions can be on eight different remote 
systems or all on one remote system, or any combination thereof, 
if the network data base has been set up accordingly. 

To communicate with several different systems across one link, an 
entry is required in the Remote Node (RN) table for each system 
associated with one DS device (lODSX) Idev, with a unique remote 
address for each remote node. To establish multiple sessions on 
a remote node, there must be multiple unique remote node names in 
the RN table associated with one DS device Idev, with the same 
remote address for each node name. 
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Using X.25/X»29 Capabilities 

WHEN TO USE A PAD 

The following considerations may be helpful in determining which 
occasions are most efficient and/or economical for using a PAD on 
a Public Data Network instead of long-distance dialing: 

• A PAD connection to the computer is advised when the cost of 
a long distance call directly to the computer would exceed 
the cost of the call to the PAD plus the packet charges for 
the amount of data sent. You should consult your PDN tariff 
charges to evaluate your particular situation, 

• When a computer is configured to use PAD terminals, it is 
less costly to use the PAD terminals than to use direct dial- 
in ports for remote communication. The incremental cost of 
configuring an additional PAD terminal into the system is 
very small compared to the cost of having another dedicated 

dial-in port. Therefore, many systems may use PADs "^ 

exclusively for terminal-to-host communication over long ■ 

distances. 

• The overall response time for interactive work with the 
computer may be longer for a connection through the PAD than 
for a direct dial- in connection. The major cause for the 
increased response time is the additional time needed by the 
PDN to process the data within the network. Also, terminal 

speeds are sometimes slower for terminals working through a ^'^ 

PAD. The allowable terminal speeds are determined by the 
network. Refer to your network's user documentation for 
allowable speeds. 

• The current CCITT X.3, X.28, and X.29 standards concerning 
the use of PADs do not provide for the use of terminals in 
block mode. Therefore, block mode programs and multichar- 
acter data transfers for HP terminals (such as tape reads) 
will not work across PADs at the present time. 
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ESTABLISHING A REMOTE SESSION VIA PAD ON PDN 



^\ 



The means by which the user establishes a connection to the 
remote HP 3000 computer is determined by the network. While 
there is a standard interface between the user and the PAD 
(described in CCITT standard X*28), each network may be somewhat 
at variance with this standard. Therefore, each terminal user 
should consult the user documentation provided by the network for 
the appropriate commands to make the connection between the 
terminal and the remote computer. 

Once the connection (virtual circuit) between the terminal and 
the computer is established, type a carriage return. The 
computer responds with a colon prompt ( : ) . Then log on as if you 
were connected locally to the computer. This communication is 
designed to allow you to operate as if you were using a local 
terminal, with a few exceptions. (For example, block mode is not 
allowed, and tape and diskette transfers are not allowed.) 



PAD PARAMETERS 
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The Packet Assembler/Disassembler (PAD) has a set of parameters 
that control its functions. The CCITT standard X.3 parameters 1 
through 12 are currently supported on most networks. Some net- 
works may also implement additional parameters which are not 
currently supported by DSN/DS. The X.3 parameters are listed 
below. Those marked with an asterisk indicate the values auto- 
matically set for the user when he establishes a session. The 
terminal user should not change these parameters. 



Parameter 
Number 



Function 



PAD recall by escape 
from data transfer 
state 



Echo by PAD 



Selection of data 
forwarding signal 



Selection of 
timer delay 



idle 



Possible Values 
(Decimal) 

Poss ible 1* 

Not possible 

Echo 1* 

No echo 

No forwarding character . . 

Carriage return 2* 

All nonprinting chars . . 126 

No idle timer used 0* 

Any number 1-255 will 
indicate delay in 
twentieths of a second 
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Parameter 
Number 



8 



Function 



Ancillary device 
control 



Suppression of PAD 
seirvice signals 



PAD action on receipt 
of BREAK 



Discard output 



9 


Padding after carriage 
return 


10 


Line folding 


11 


Binary speed 


12 


Flow control of the 



PAD by terminal 



Possible Values 
(Decimal) 

No use of X-ON (DCl) or 

X-OFF (DC3) 

Use of X-ON and X-OFF 1* 

No service signals are 

sent to terminal 

Service signals sent 1* 

Send host interrupt 

packet 1 

Reset 2 

Send host an indication of 

a break PAD message .... U 
Escape from data 

transfer state 8 

Discard output to 

terminal l6 

Send interrupt packet » 

send indication of breaks 

discard output 21* 

Do nothing 

Normal data delivery to 

terminal 0* 

Discard output to the 

terminal 1 

Set according to the 

data rate of terminal . . 0* 
Number of padding 

characters 1-7 

No folding 0** 

Number of characters 

per line 1-255 

READ ONLY. SET BY PAD 

No use of XON or XOFF 

for flow control 

Use of XON and XOFF 1* 
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Using X.23/X.29 Capabilities 



TERMINAL RESTRICTIONS ON THE PUBLIC 
DATA NETWORK 

There are certain restrictions on the use of a terminal ruzming 
through the PAD* Some of these restrictions are: 

e Block mode transfers will not work. 

• Multicharacter transfers will not work. (See the manual for 
the particular terminal you are using for a definition of 
multicharacter transfers.) 

• The terminal sx>eed must be set maoiually; it cannot be set 
programmat ically • 

• Parity must be zero with no parity checking. 

• Control sequences (such as Control-X and Control-Y, but not 
Control-S and Control-Q) must be forwarded with a carriage 
return. 

• All data must be forwarded with a carriage return. 

• The PAD terminal cannot be used as a console tezminal. 



WHICH TERMINALS TO USE 

The following HP terminals will operate across a PAD (not in 
block/page mode ) : 

HP 2382 

HP 262IA, 262IB, 262IP, 2622, 2623, 262UA, 262UB, 2626A 

HP 2635, 26UOB, 26UOB, 26i42*, 26itU*, 26U5A*, 26U7*, 26U8* 

(* Not including cassette tape or diskette transfers.) 
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The following HP desktop and personal computers will operate 
across a PAD in terminal emulation mode: 

HP 85 
HP 87 
HP 125 
HP 9826 
HP 9836 
HP 9835* 
HP 98U5* 

(* These desktop computers should be set to work in character 
mode , not in line mode . ) 
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CONFIGURING YOUR TERMINAL 

Terminals operating across a PAD must be configured in the 
following manner: 

1. The PAD does not use the HP standard ENQ/ACK handshake to 

allow the terminal to control the flow of data to it. At ^^ 

terminal speeds up to 2UOO baud, the CRT terminals without 
attached or integrated printers need no flow control. How- 
ever, printing terminals (terminals with attached printers or 
integrated printers) must be set to use XOM/XOFF receive 
pacing. This setting allows the terminal to control the flow 
of data from the PAD, so as to avoid sending data characters 
to the terminal faster than the printer can print them. 
Attached printers must also be set to use the XON/XOFF flow 
control of the terminal to which they are connected. "^ 

2. Since terminals may have different line lengths, the initial 
configuration of the PAD does not specify a line length. The 
terminal user sets the line length before automatic wrap- 
aroimd for his particular terminal and application. Hewlett- 
Packard CRT terminals use the 80- character line length as the 
default. Printing terminals may use longer line lengths. 
Set the line length prior to logging on. 

3. Set your terminal as follows: 

For HP 26Ux-series terminals, manually set the G and H 
straps in your terminal to the open position to inhibit the 
use of handshaking and DC2. 

For menu-driven terminals, set: y^s^ 

INHIBIT HANDSHAKING (G) = YES ] 

INHIBIT DC2 (H) = YES 
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Using X,25/X.29 Capabilities 

CHARACTERISTICS OF PAD 

The terminal running across a PAD behaves slightly differently 
than a local terminal. You will notice the following behavioral 
differences : 

• In a local environment » a line feed is sent immediately to 
the terminal when a read is completed. However » a terminal 
on the PAD receives the line feed at the beginning of the 
next write to the terminal • This method is more economical, 
since the line feed is sent as the first item in the next 
write data packet rather than its being sent in a packet by 
itself, 

m Writes to the terminal are buffered until the next I/O 

request is processed. Thus it is possible that a write to 
the terminal will be delayed if a large amount of data 
processing is done between terminal I/O operations. 

m Some network PADs will not echo escape sequences entered from 
the keyboard. 



PROGRAM COMPATIBILITY WITH PAD 

The following HP software products are compatible with the Packet 
Assembler/Disassembler (PAD) on a Public Data Network and will, 
therefore, operate correctly across a PAD: 

All MPE commands 

DSN/DS commands 

All compilers sind interpreters 

EDIT/3000 

TDP/3000 (not in screen mode) 

FCOPY 

MPE Utilities 

MPE Segmenter 

SORT/3000 
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Using X.23/X.29 Capabilities 

There are other HP software products that will not work correctly /«% 
across a PAD, however. Most of the programs in this category 1 

won't work because they operate in block mode, but others don't 
work because they, programmatically change the terminal strap 
settings to settings that are incompatible with the PAD interface 
requirements for flow control. IRitil further notice, do NOT 
attempt to use the following HP software products across a PAD — 
these programs can "hang" (or "lock up") the user's terminal: 

RAPID/3000 

DSG/3000 

HPDRAW 

V/3000, VPLUS/3000 

HPSLATE 

HPTOOLSET 

HPWORD 

HPEASYCHART 

PSP/3000 

IFS/2680 

MM/3000 

PM/3000 

GA/3000 

PLANT MAINTEMANCE/3000 ^ 

TDP/3000 (in screen mode) 

Console operator commands (a PAD terminal cannot be 
the console). 
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ASCII CHARACTER SET 


appendix! 


K 


ASCII 


First Character 


Second Character 




ASCII 


First Character 


Second Character 


Character 


Octal Equivalent 


Octal Equivalent 




Character 


Octal Equivalent 


Octal Equivalent 


A 


040400 


000101 


ACK 


003000 


000006 


B 


041000 


000102 




BEL 


003400 


000007 


C 


041400 


000103 




BS 


004000 


000010 


D 


042000 


000104 




HT 


004400 


00001 1 


E 


042400 


000105 




LF 


005000 


000012 


F 


043000 


000106 




VT 


005400 


000013 


G 


043400 


000107 




FF 


006000 


000014 


H 


044000 


000110 




CR 


006400 


000015 


1 


044400 


0001 1 1 




SO 


007000 


000016 


J 


045000 


000112 




SI 


007400 


000017 


K 


045400 


000113 




OLE 


010000 


000020 


L 


046000 


000114 




DC1 


010400 


000021 


M 


046400 


000115 




DC2 


011000 


000022 


N 


047000 


000116 




DC3 


011400 


000023 





047400 


000117 




DC4 


012000 


000024 


P 


050000 


000120 




NAK 


012400 


000025 


Q 


050400 


000121 




SYN 


013000 


000026 


R 


051000 


000122 




ETB 


013400 


000027 


S 


051400 


000123 




CAN 


014000 


000030 


T 


052000 


000124 




EM 


014400 


000031 


U 


052400 


000125 




SUB 


015000 


000032 


V 


053000 


000126 




ESC 


015400 


000033 


w 


053400 


000127 




FS 


016000 


000034 


X 


054000 


000130 




GS 


016400 


000035 


Y 


054400 


000131 




RS 


017000 


000036 


z 


055000 


000132 




US 
SPACE 


017400 
020000 


000037 
000040 


a 


060400 


000141 




I 


020400 


000041 


b 


061000 


000142 




" 


021000 


000042 


c 


061400 


000143 




# 


021400 


000043 


d 


062000 


000144 




$ 


022000 


000044 


e 


062400 


000145 




% 


022400 


000045 


f 


063000 


000146 




& 


023000 


000046 


g 


063400 


000147 




' 


023400 


000047 




064000 


000150 




( 


024000 


000050 




064400 


000151 




) 


024400 


000051 




065000 


000152 




♦ 


025000 


000052 


k 


065400 


000153 




+ 


025400 


000053 


1 


066000 


000154 




, 


026000 


000054 


m 


066400 


000155 




- 


026400 


000055 


n 


067000 


000156 






027000 


000056 





067400 


000157 




/ 


027400 


000057 


P 


070000 


000160 






035000 


000072 


q 


070400 


000161 




; 


035400 


000073 


r 


071000 


000162 




< 


036000 


000074 


s 


071400 


000163 




= 


036400 


000075 


t 


072000 


000164 




> 


037000 


000076 


u 


072400 


000165 




? 


037400 


000077 


V 


073000 


000166 




@ 


040000 


000100 


w 


073400 


000167 




[ 


055400 


000133 


X 


074000 


000170 




\ 


056000 


000134 


y 


074400 


000171 




1 


056400 


000135 


z 


075000 


000172 




A 


057000 
057400 


000136 
000137 





030000 


000060 




{ 


060000 


000140 


1 


030400 


000061 




075400 


0001 73 


2 


031000 


000062 




1 


076000 


000174 


3 


031400 


000063 




} 


076400 


000175 


4 


032000 


000064 






077000 


000176 


5 
6 

7 


032400 
033000 
033400 


000065 
000066 
000067 




DEL 


077400 


0001 77 




8 


034000 


000070 




9 


034400 


000071 


First Character Second Character 


NUL 
SOH 


000000 
000400 


000000 
000001 




A A 




r ^\r ^ 


STX 
ETX 
EOT 
ENQ 


001000 
001400 
002000 
002400 


000002 
000003 
000004 
000005 


* f \ 
1 1 1 























1 


2 


3 


4 


5 


6 


7 


8 £ 


) 10 


11 


12 


13 


14 


15 
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ACCEPT Intrinsic, 5-8 

Access, command, remote file, U-2 

Access, programmatic, remote file, U-20 

Adding to the LC table, H-10 

Adding to the RN table, H-6 

Advantages of a Distributed System, 5-5 

Applications, DS, 7-1 

ASCII Character Set, K-1 



B 

BACCEPT Intrinsic, BASIC Interface, G-U 

BASIC Interface, DSH/DS, G-1 

BASIC Interface intrinsics, G-2 

BASIC, interfacing with, 5-30, G-1 

Batch job, establishing a remote session from a, 3-5 

BGET Intrinsic, BASIC Interface, G-U 

BPCHECK Intrinsic, BASIC Interface, G-5 

BPCLOSE Intrinsic, BASIC Interface, G-U 

BPCONTROL Intrinsic, BASIC Interface, G-U 

BPOPEN Intrinsic, BASIC Interface, G-2 

BPREAD Intrinsic, BASIC Interface, 0-3 

BPWRITE Intrinsic, BASIC Interface, G-3 

BREAK key, 3-5 

BREJECT Intrinsic, BASIC Interface, G-5 

Buffers 

Continuation, 7-6 

Line, 7-6 



CACCEPT Intrinsic, COBOL Interface, F-U 

CGET Intrinsic, COBOL Interface, F-U 

Character Set, ASCII, K-1 

Closing a Line, 2-67 

COBOL Interface intrinsics, F-2 

COBOL Interface, DSN/DS, F-1 

COBOL, interfacing with, 5-30, F-1 

COBOL Remote File Access example, U-19 

COBOLGO Remote File Access example, U-l6 

Command access, remote file, ^4-2 

Commands 

A[dd] , H-5 

C[heck], H-18 

CLEAR, D-1 

DATA=, D-1 

D[elete], H-19 

DISPLAY, D-1 
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Commands ( cont inued ) 

DSCONTROL, C-1 

DSCOPY, 6-3 

DSLINE, 2-n, 2-67 

ERRORS, 0-1 

E[xit], H-25 

EXIT, D-1 

FILE, U-3 

GO, D-1 

H[elp], H-26 

HELP, D-2 

L[ist], H-27 

NEWDEV, D-2 

NEWFILE, D-2 

°^S, D-2 

PINS=, D-2 ^ 

P[rint], H-29 

RANGE, D-2 

REMOTE prefix, 3-6 

REMOTE HELLO, 2-UU 

TIMES=, D-2 

TYPES=, D-2 

U[pdate] , H-30 
Commvmicatlons, Interprocess, 7''13 ymt. 

Communications Link ) 

definition of, 2-1 

established, 2-1 
Comparison: Single System vs. Distributed System, 3-5 
Compression, 2-13» 7-7 
Configuration Dialogue, MPE, A-1 
Console Command, :DSCON13tOL, C-1 
Continuation Buffers, 7-6 
Control keys, 3-8 
Conventions 

DSN/DS BASIC Interface, G-1 

DSN/DS COBOL Interface, F-1 

Used in this manual, xiv 
Coordinating Master and Slave Programs, 7-k 
Copy 

Local, 6-7 

Remote-to-Local, 6-7 

Local-to-Remote, 6-7 

Remote, 6-7 

Remote- to -Remote, 6-7 
CPCHECK Intrinsic, COBOL Interface, F-5 
CPCLOSE Intrinsic, COBOL Interface, F-U 
CPCONTROL Intrinsic, COBOL Interface, F-3 
CPOPEN Intrinsic, COBOL Interface, F-2 
CPREAD Intrinsic, COBOL Interface, F-3 

CPWRITE Intrinsic, COBOL Interface, F-3 '^ 

CREJECT Intrinsic, COBOL Interface, F-3 '' 

CSHBSCO (HSI driver), 2-7, A-13 
CSSBSCO (SSLC driver), 2-7, A-13 
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Data compression, 2-13 ^ 7"7 
Debugging, 7-5 
Definitions 

Communications Link, 2-1 

DSN/DS, 1-1 

Hardwired Line, 2-2 

HP-DSN, 1-1 

Modem, 2-U 
device parameter, FOPEN Intrinsic, U-22 
Deleting from the LC table, H-2I4 
Deleting from the RN table, H-21 
Device Table, I/O, 2-8, 2-9 
Diagnostic mode. System Verification, E-2 
Dialing the Remote Computer, 2-15 
Distributed System compared to a single system, 5-5 
Distributed Systems Network, 1-1 
Driver 

DSN/DS communications, 2-7, A-I3 

HSI, 2-7, A-13 

INF, 2-7, A-13 

SSLC, 2-7, A-13 

Virtual terminal, 2-10, A-13 
DSN/DS communications driver (lODSO or lODSX) , 2-7, A-13 
DSN/DS Communications Link (diagram), 2-1 
DSN/DS, definition of, 1-1 
DSN/DS Functional Error messages, B-2 
DSN/DS line buffer example (diagram), 2-3 
DSCONTROL 

Console Command (: DSCONTROL ) , C-1 

Error Messages, B-U 

Informatory Messages, B-h 
DSCOPY 

BASIC Example, 6-I5 

COBOL Example, 6-lU 

Command, 6-3 

Event recording, S-B 

FORTRAN Example, 6-lU 

Interactive mode, 6-6 

Intrinsic, 6-9 

Programmatic operation, 6-11 

Source files, 6-5 

Target files, 6-5 
DSCOPYMSG Intrinsic, 6-12 

dsdevice, 2-12, 2-U7, 2-67, U-2, U-20, U-22 
DSDUMP Program, D-1 
DSDUMP 

Commands, D-1 

Operating tips, D-5 

Operation, D-3 

Output, D-U 

Preparation, D-U 

Running the program interactively, D-U 

Streaming the program, D-U 
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DSLINE 

Closing a line with, 2-67 
Command (:DSLINE), 2-11, 2-6? 
Opening a line with, 2-11 
Parameters, 2-11, 2-67 
Syntax, 2-11, 2-67 
Sjmtax Error messages, B-1 

DS/X,25» 1-1» H-1, J-1 



Entering REMOTE, 3-7 

Error Codes and Messages, B-1 

Error Codes and Messages ^.^m^ 

DSN/DS Functional Errors, B-2 ^ 

:DSCONTROL Error Messages, B-U 

:DSCONTROL Informatory Messages, B-k 

: DSLINE Syntax Errors, B-1 
EXCLUSIVE, 2-12 
Exclusive option examples, 2-20, 2-21, 2-22, 2-23 



Failures, line-opening, 2-66 

FCOPY Remote File Access example, U-13 

Features of DSN/DS, 1-1 

Features of NFT, 6-1 

FILE Command 

parameters, U-U 

syntax, U-3 
FOPEN Intrinsic ^.^^ 

parameters, U-22 ^^j 

syntax, U-21 
Formats for inserted Compression characters, 7~8 

G 

GET Intrinsic, 5-10 

H 

Hardwired line, specifying a, 2-7 

Hardwired Serial Interface (HSI), 2-2, 2-U 

HP 3000 to HP 3000 example (diagram) , 1-3 

HP 30010A Intelligent Network Processor (INP), 2-2, 2-U 

HP 30020A Intelligent Network Processor (INP), 2-2, 2-U 

HP 30020B Intelligent Network Processor (INP), 2-2, 2-U 

HP 30055A Synchronous Single-Line Controller (SSLC), 2-2, 2-U 

HP 3036OA Hardwired Serial Interface (HSI), 2-2, 2-U 

HSI, 2-2, 2-U 
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HSI — Its place in a Distributed Systems Network* 2-2, 2-U 
HSI driver (CSHBSCO), 2-7, A-13 



ID Sequences, 2-l6 

Initiating the local session, 1-3 » 1-U, 2-5U, 2-6l 

Initiating the remote session, 1-3 

INP, 2-2, 2-U 

INP -- Its place in a Distributed Systems Network, 2-2, 2-U 

INP driver (lOINPO), 2-7, A-13 

Intelligent Network Processor (INP), 2-2, 2-U 

Interfacing with BASIC, 5-30, G-1 

Interfacing with COBOL, 5-30, F-1 

Interprocess Communications (IPC), 7-13 

Intrinsics 

DSN/DS BASIC Interface, G-2 

DSN/DS COBOL Interface, F-2 

PTOP Master, 5-3 

Program- to -Program, 5-3, 5-U, F-2, G-2 

PTOP Slave, 5-U 
I/O device table (hardwired line), 2-8 
I/O device table (telephone line), 2-9 
lODSTRMO (virtual-terminal driver), 2-10, A-13 
lODSTRMX (X.25 virtual terminal driver), 2-10, A-13 
lODSX (X.25 communications driver), 2-7, A-13 
lODSO (communications driver), 2-7, A-13 
lOINPO (INP driver), 2-7, A-13 
lOPADO (PAD terminal driver), A-13 

IPC, 7-13 

Issuing local commands, 3-8 
Issuing remote commands, 3-2 



LC table 

Adding to, H-IO 

Deleting from, H-2U 

Updating, H-3U 
Line buffer exatmple, 2-3 
Line Buffers, 7-6 

Line Characteristics (LC) table, H-3 
Line-opening failures, 2-66 

List of master program-to-program intrinsics, 5-3 
List of slave program-to-program intrinsics, 5-U 
Local commands, issuing, 3-8 
Local session, initiating the, 1-3, 1-U, 2-5U, 2-6l 
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Master PTOP intrinsics, 5-3 
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:DSCONTROL Error Messages, B-U 

:DSCONTROL Informatory Messages, B-U 

:DSCOPY General Error Messages, B-6 

:DSCOPY Intrinsic Error Returns, B-7 

:DSCOPY Internal Errors, B-7 

:DSLINE Syntax Errors, B-1 

DSN/DS Functional Errors, B-2 

Error, B-1 
Modem, definition of, 2-U 
MPE 

Configuration Dialogue, A-1 

FILE Command parameters, U-U 

FILE Command syntax, U-3 

FOPEN Intrinsic parameters, U-22 

FOPEN Intrinsic syntax, U-21 
Multiple line example (hardwired lines), 2-32 
Multiple line example (telephone lines), 2-39 
Multiple Remote Access, 7-10 

Multiple user examples (hardwired line), 2-l8, 2-19 
Multiple user examples (dial-up line), 2-2U -- 2-lt3 
Multiple users, 2-17 
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NETCONF 

Commands, H-U 

Data base organization, H-3 

Using, H-3 

Utility, H-2 
Network Configurator, X-25/X.21, H-1 
Network File Transfer (NFT), 6-1 

NFT features, 6-1 ^^ 

NFT intrinsics, 6-8 ^ 

Normal mode. System Verification, E-U 



Opening a Line, 2-2 
Opening a hardwired line, 2-2 
Opening a telephone line, 2-U 
Opening multiple lines, 2-31 



PAD 

Characteristics , J-7 

Establishing a remote session via, J-3 

Program compatibility with, J-7 

Parameters, J-3 

VJhen to use a, J- 2 
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Parameters 

DSCONTROL Command, C-2 

DSCOPY Command, 6-3 

MPE FILE Command, U-U 

MPE FOPEN Intrinsic, 14-22 

PAD, J-3 
PCHECK Intrinsic, 5-13 
PCLOSE Intrinsic, 5-15 
PCONTROL activity (diagram), 5-17 
PCOHTROL Intrinsic, 5-l6 
Performance, 7-8 
POPEN activity (diagram), 5-23 
POPEN Intrinsic, 5-I8 
PREAD activity (diagram), 5-26 
PREAD Intrinsic, 5-2^4 

Prefixing each command with "REMOTE", 3-6 
Program-to-Program Communications, 5-I 
Program-to-Program intrinsics, 5-7, F-2, G-2 
Programmatic access, remote file, U-20 
Programmatic DSCOPY operation, 6-11 
PTOP Intrinsics 

ACCEPT, 5-8 

GET, 5-10 

PCHECK, 5-13 

PCLOSE, 5-15 

PCONTROL, 5-16 

POPEN, 5-18 

PREAD, 5-2U 

PWRITE, 5-27 

REJECT, 5-29 
PWRITE activity (diagram), 5-28 
PWRITE Intrinsic, 5-27 



REJECT Intrinsic, 5-29 
Remote access, multiple, 7-10 
REMOTE Command prefix, 3-6 
Remote commands, issuing, 3-2 
Remote File Access (RFA), k-1 
REMOTE HELLO Command, 2-UU 
Remote listing performance, 7*9 
Remote Node (RN) table, H-3 
Remote off-line listing example, U-7 
Remote session, initiating the, I-5 
REMOTE, entering, 3-7 
RFA, U-1 
RN table 

Adding to, H-6 

Deleting from, H-21 

Updating, H-32 
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Sample I/O device table, 2-8, 2-9 

Slave PTOP intrinsics, 5"^ 

Software Version Report, E-1 

SORT Remote File Access example, U-10 

Specifying a hardwired line, 2-7 

Specifying a telephone line, 2-7 

SSLC, 2-2, 2-U 

SSLC — Its place in a Distributed Systems Network, 2-2, 2-U 

SSLC driver (CSSBSCO), 2-7, A-13 

Streaming the DSDUMP Program, D-U 

Supplemental manuals, v 

Synchronous Single-Line Controller (SSLC), 2-2, 2-U 

Syntax 

DSCONTROL Command, C-2 ,,,s^ 

DSCOPY Command, 6-3 ; 

MPE FILE Command, U-3 

MPE FOPEN Intrinsic, 14-21 
System Verification, E-1 
System Verification Test 

Diagnostic Mode, E-2 

Normal Mode, E-U 
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Table, I/O Device, 2-8, 2-9 

Telephone line, specifying a, 2-7 

Terminal restrictions on the Public Data Network, J-3 

Tezminal, configuring your, J-6 

Terminals, which to use, J-5 

Terminating a remote session from the local session, 3*9 

Terminating a remote session from the remote session, 3-10 

Transmissions Between Systems, 7*3 



U 

Updating the LC table, H-3U 

Updating the RN table, H-32 

Users, multi|>le, 2-17 

Using the Remote Subsystem From a Batch Job, 3"3 



V 

Virtual-terminal driver (lODSTRMO or lODSTRMX), 2-10, A-13 

W 

What Is a Communications Link?, 2-1 
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Canberra, Australia 
Capital Territory 
Office 

Hewlett-Packard Australia Ltd. 

121 Wollongong Street 

FYSHWICK, A.C.T. 2609 

Tel: 80 4244 

Telex: 62650 

Cable: HEWPARD Canberra 

CH.CM.E,P 

Melbourne, Victoria Office 

Hewlett-Packard Australia Ltd. 

31-41 Josepli Street 

BUCKBURN. Victoria 3130 

Tel: 877 7777 

Telex: 31-024 

Cable: HEWPARD Melbourne 

A.CH,CM.CS,E,MS.P 

Perth, Western Australia 

Office 

Hewlett-Packard Australia Ltd. 

261 Stirling Highway 

CLAREMONT, W.A. 6010 

Tel: 383-2188 

Telex: 93859 

Cable: HEWPARD Perth 

A.CH.CM,.E.MS.P 

Sydney, New South Wales 

Office 

Hewlett-Packard Australia Ltd. 

17-23 Taiavera Road 

P.O. Box 308 

NORTH RYDE,N.S.W. 2113 

Tel: 887-1611 

Telex: 21561 

Cable: HEWPARD Sydney 

A.CH,CM,CS.E,MS.P 

AUSTRIA 

Hewlett-Packard Ges.m.b.h. 

Grottenhofstrasse 94 

Verkaufsburo Graz 

A-8052 GRAZ 

Tel: 291-5-66 

Telex: 32375 

CH.E* 

Hewlett-Packard Ges.m.b.h. 

Stanglhofweg 5 

A-4020 LINZ 

Tel: 0732 51585 

CH 

Hewlett-Packard Ges.m.b.h. 

Lieblgasse 1 

P.O. Box 72 

A- 1222 VIENNA 

Tel: (0222) 23-65-11-0 

Telex: 134425 HEPA A 

A,CH,CM.CS,E,MS,P 



BAHRAIN 

Green Salon 

P.O. Box 557 

BAHRAIN 

Tel: 255503-255950 

Telex: 84419 

P 

Wael Pharmacy 

P.O. Box 648 

BAHRAIN 

Tel: 256123 

Telex: 8550 WAEL BN 

M,E 

BELGIUM 

Hewlett-Packard Belgium S.A./N.y. 

Blvd de la Woluwe. 100 

Woluwedal 

B- 1200 BRUSSELS 

Tel: (02) 762-32-00 

Telex: 23-494 paloben bru 

A.CH.CM.CS,E,MP,P 

BRAZIL 

Hewlett-Packard do Brasil i.e.C. 

LIda. 

Alameda Rio Negro. 750 

Alphaville 06400 BARUERISP 

Tel: (11) 421-1311 

Telex: 01 133872 HPBR-BR 

Cable: HEWPACK Sao Paulo 

A,CH.CM.CS.E.M.P 

Hewlett-Packard do Brasil I.e.C. 

Ltda. 

Avenida Epitacio Pessoa, 4664 

22471 RIO DEJANEIRO-RJ 

Tel: (21) 286-0237 

Telex: 021-21905 HPBR-BR 

Cable: HEWPACK Rio de Janeiro 

A,CH,CM.E,MS.P* 

CANADA 

Alberta 

Hewlett-Packard (Canada) Ltd. 
210, 7220 Fisher Street.S.E. 
CALGARY, Alberta T2H 2H8 
Tel: (403) 253-2713 
A.CH,CM.E*.MS.P* 
Hewlett-Packard (Canada) Ltd. 
11620A-168th Street 
EDMONTON, Alberta T5M 3T9 
Tel: (403) 452-3670 
A,CH,CM,CS.E.MS,P* 

British Columbia 

Hewlett-Packard (Canada) Ltd. 

10691 Shellbridge Way 

RICHMOND, 

British Columbia VOX 2W7 

Tel: (604) 270-2277 

Telex: 610-922-5059 

A.CH.CM,CS,E*.MS.P* 

Manitoba 

Hewlett-Packard (Canada) Ltd. 
380-550 Century Street 
WINNIPEG, Manitoba R3H 0Y1 
Tel: (204) 786-6701 
A,CH.CM,E.MS,P* 

New Brunswick 

Hewlett-Packard (Canada) Ltd. 

37 Sheadiac Road 

MONCTON, New Brunswick E2B 2V0 

Tel: (506) 855-2841 

CH** 

Nova Scotia 

Hewlett-Packard (Canada) Ltd. 

P.O. Box 931 

900 Windmill Road 

DARTMOUTH, Nova Scotia B2Y 3Z6 

Tel: (902) 469-7820 

CH.CM.CS.E*,MS,P* 



Ontario 

Hewlett-Packard (Canada) Ltd. 
552 Newbold Street 
LONDON, Ontario N6E 2S5 
Tel: (519) 686-9181 
A,CH,CM.E*,MS,P* 
Hewlett-Packard (Canada) Ltd. 
6877 Goreway Drive 
MiSSISSAUGA, Ontario L4V 1M8 
Tel: (416) 678-9430 
A,CH.CM,CS,E,MP,P 
Hewlett-Packard (Canada) Ltd. 
2670 Oueensview Dr. 
OHAWA, Ontario K2B8K1 
Tel: (613) 820-6483 
A,CH,CM,CS,E*,MS.P* 
Hewlett-Packard (Canada) Ltd. 
220 Yorkland Blvd.. Unit #11 
WILLOWDALE. Ontario M2J 1R5 
Tel: (416) 499-9333 
CH 

Quebec 

Hewlett-Packard (Canada) Ltd. 
17500 South Service Road 
Trans-Canada Highway 
KIRKLAND, Quebec H9J 2M5 
Tel: (514) 697-4232 
A.CH.CM.CS.E.MP,P* 
Hewlett-Packard (Canada) Ltd. 
Les Galeries du Valion 
2323 Du Versont Nord 
STE.F0Y, Quebec GIN 4C2 
Tel: (418) 687-4570 
CH 

CHILE 

Jorge Calcagniy Cia. Ltda. 

Arturo Burhle 065 

Casllla 16475 

SANTIAGO 9 

Tel: 222-0222 

Telex: Public Booth 440001 

A.CM,E,M 

Olympia (Chile) Ltda. 

Av. Rodrigo de Araya 1045 

Casilla 256-V 

SANTIAGO 21 

Tel: 2-25-50-44 

Telex: 340-892 OLYMP CK 

Cable: Olympiachile Santlagochile 

CH,CS.P 

CHINA, People's Republic 
of 

China Hewlett-Packard Rep. Office 

P.O. Box 418 

1A Lane 2, Luchang SL 

Beiwei Rd., Xuanwu District 

BEIJING 

Tel: 33-1947, 33-7426 

Telex: 22601 CTSHP CN 

Cable: 1920 

A,CH.CM.CS.E.P 

COLOMBIA 

Instrumentacidn 

H. A. Langebaek <S Kier S.A. 

Carrera 7 No. 48-75 

Apartado Aereo 6287 

BOGOTA 1, D.E 

Tel: 287-8877 

Telex: 44400 INST CO 

Cable: AARIS Bogota 

A,CM,E,M,PS,P 

COSTA RICA 

Cientifica Costarricense S.A. 

Avenida 2, Calle 5 

San Pedro de Monies de Oca 

Apartado 10159 

SANJOSE 

Tel: 24-38-20. 24-08-19 

Telex: 2367 GALGUR CR 

CM.E.MS.P 



CYPRUS 

Telerexa Ltd. 

P.O. BOX 4809 

14C Stassinos Avenue 

NICOSIA 

Tel: 62698 

Telex: 2894 LEVIDO CY 

E.M,P 

DENMARK 

Hewlett-Packard A/S 
Datavej 52 
DK-3460 Birkerod 
Tel: (02) 81-66-40 
Telex: 37409 hpas dk 
A.CH,CM.CS.E.MS.P 
Hewlett-Packard A/S 
Navervej 1 
DK-8600 SILKEBORG 
Tel: (06) 82-71-66 
Telex: 37409 hpas dk 
CH,E 

ECUADOR 

CYEDE Cia. Ltda. 

Avenida Eloy Alfaro 1749 

Casilla 6423 CCI 

QUITO 

Tel: 450-975. 243-052 

Telex: 2548 CYEDE ED 

A,CM.E,P 

Hospitalar S.A. 

Robles 625 

Casilla 3590 

QUITO 

Tel: 545-250, 545-122 

Telex: 2485 HOSPTL ED 

Cable: HOSPITALAR-Ouito 

M 

EGYPT 

International Engineering 

24 Hussein Hegazi Street 

Kasr-el-Alnl 

CAIRO 

Tel: 23829. 21641 

Telex: lEA UN 93830 

CH.CS,E.M 

Informatic For Systems 

22 Talaat Harb Street 

CAIRO 

Tel: 759006 

Telex: 93938 FRANK UN 

CH.CS.P 

Egyptian International Office 

for Foreign Trade 

P.O.Box 2558 

CAIRO 

Tel: 650021 

Telex: 93337 EGPOR 

P 

EL SALVADOR 

IPESA de El Salvador S.A. 

29 Avenida Norte 1216 

SAN SALVADOR 

Tel: 26-6858. 26-6868 

Telex: Public Booth 20107 

A.CH,CM.CS.E.P 

FINLAND 

Hewlett-Packard Oy 
Revontulentie 7 
SF-02100ESP00 10 
Tel: (90) 455-0211 
Telex: 121563 hewpa sf 
A.CH.CM.CS.E.MS,P 
Hewlett-Packard Oy 
Aatoksenkatv 10-C 






SALES & SUPPORT OFFICES 

Arranged Alphabetically by Country 



SF-40720-72 JYVASKYLA 
Tel: (941) 216318 
CH 

Hewlett-Packard Oy 
Kainvuntie 1-C 
SF-90140-14 OULU 
Tel: (981) 338785 
CH 

FRANCE 

Hewlett-Packard France 

Z.I. Mercure B 

Rue Berfhelot 

F-13763Les Mines Cedex 

AIX-EN-PROVENCE 

Tel: (42) 59-41-02 

Telex: 410770F 

A,CH,E,MS,P* 

Hewlett-Packard France 

Boite Postale No. 503 

F-25026 BESANCON 

28 Rue de la Repubilque 

F-25000 BESANCON 

Tel: (81) 83-16-22 

CH.M 

Hewlett-Packard France 

Bureau de Vente de Lyon 

Chemin des Mouilles 

Boite Postale 162 

F-69130ECULLYC6dex 

Tel: (7) 833-81-25 

Telex: 310617F 

A,CH,CS.E.MP 

Hewlett-Packard France 

Immeuble France Evry 

Tour Lorraine 

Boulevard de France 

F-91035EVRYC6dex 

Tel: (6) 077-96-60 

Telex: 692315F 

E 

Hewlett-Packard France 

5th Avenue Raymond Chanas 

F-38320 EYBENS 

Tel: (76) 25-81-41 

Telex: 980124 HP GRENOB EYBE 

CH 

Hewlett-Packard France 

Centre d' Affaire Paris-Nord 

B§timent Ampere 5 etage 

Rue de la Commune de Paris 

Boite Postale 300 

F-93153 IE BLANC MESNIL 

Tel: (01) 865-44-52 

Telex: 21 1032F 

CH.CS.E.MS 

Hewlett-Packard France 

Pare d'Activites Cadera 

Ouartier Jean Mermoz 

Avenue du President JF Kennedy 

F-33700 MERIGNAC 

Tel: (56) 34-00-84 

Telex: 550105F 

CH.E,MS 

Hewlett-Packard France 

32 Rue Lothaire 

F-57000 METZ 

Tel: (8) 765-53-50 

CH 

Hewlett-Packard France 

Immueble Les 3 B 

Nouveau Chemin de la Garde 

Z.A.C. de Bois Briand 

F-44085 NANTES Cedex 

Tel: (40) 50-32-22 

CH'- 

Hewlett-Packard France 

Zone Industrielie de Courtaboeuf 

Avenue des Tropiques 

F-91947 Les Ulis C6dex ORSAY 

Tel: (6) 907-78-25 

Telex: 600048F 

A,CH.CM,CS,E,MP,P 



Hewlett-Packard France 

Paris Porte-Maillot 

15, Avenue De L'Amiral Bruix 

F-75782 PARIS 16 

Tel: (1) 502-12-20 

Telex: 613663F 

CH.MS,P 

Hewlett-Packard France 

2 Allee de ta Bourgonette 

F-35100RENNES 

Tel: (99) 51-42-44 

Telex: 740912F 

CH,CM.E.MS,P* 

Hewlett-Packard France 

98 Avenue de Bretagne 

F-76100 ROUEN 

Tel: (35) 63-57-66 CH*'.CS 

Hewlett-Packard France 

4 Rue Thomas Mann 

Boite Postale 56 

F-67200 STRASBOURG 

Tel: (88) 28-56-46 

Telex: 890141F 

CH,E.MS.P* 

Hewlett-Packard France 

Pericentre de la C6piere 

F-31081 TOULOUSE Cedex 

Tel: (61) 40-11-12 

Telex: 531639F 

A.CH,CS.E.P' 

Hewlett-Packard France 

Immeuble Pericentre 

F-59658 VtLLENEUVE D'ASCQ Cedex 

Tel: (20) 91-41-25 

Telex: 160124F 

CH,E,MS.P* 

GERMAN FEDERAL 

REPUBLIC 

Hewlett-Packard GmbH 
Technisches BUro Berlin 
Keithstrasse 2-4 
D-1000 RERUN 30 
Tel: (030) 24-90-86 
Telex: 018 3405 hpbin d 
A.CH.E.M,P 

Hewlett-Packard GmbH 
Technisches BUro BObiingen 
Herrenberger Strasse 110 
0-7030 BOBLINQEN 
Tel: (07031) 667-1 
Telex: bbn or 
A,CH,CM.CS.E.MP.P 
Hewlett-Packard GmbH 
Technisches BUro Dusseldorf 
Emanuel-Leutze-Strasse 1 
D-4000 DUSSELDORF 
Tel: (0211) 5971-1 
Telex: 085/86 533 hpdd d 
A,CH,CS.E.MS,P 
Hewlett-Packard GmbH 
Vertriebszentrale Frankfurt 
Berner Strasse 117 
Postfach 560 140 
D-6000 FRANKFURT 56 
Tel: (061 1)50-04-1 
Telex: 04 13249 hpffm d 
A.CH,CM.CS.E.MP.P 
Hewlett-Packard GmbH 
Technisches BUro Hamburg 
Kapstadtring 5 
D-2000 HAMBURG 60 
Tel: (040) 63804-1 
Telex: 021 63 032 hphh d 
A.CH.CS.E.MS,P 
Hewlett-Packard GmbH 
Technisches BUro Hannover 
Am Grossmarkt 6 
D-3000 HANNOVER 91 
Tel: (0511) 46-60-01 
Telex: 092 3259 
A.CH.CM.E.MS.P 



Hewlett-Packard GmbH 

Technisches BUro Mannheim 

Rosslauer Weg 2-4 

D-6800 MANNHEIM 

Tel: (0621) 70050 

Telex: 0462105 

A.C,E 

Hewlett-Packard GmbH 

Technisches BUro Neu Uim 

Messerschmittstrasse 7 

D-7910NEUULM 

Tel: 0731-70241 

Telex: 0712816 HP ULM-D 

A,C.E* 

Hewlett-Packard GmbH 
Technisches BUro NUrnberg 
Neumeyerstrasse 90 
D-8500 NURNBERG 
Tel: (0911) 52 20 83-87 
Telex: 0623 860 
CH.CM.E.MS.P 
Hewlett-Packard GmbH 
Technisches BUro MUnchen 
Eschenstrasse 5 
D-8028TAUFKIRCHEN 
Tel: (089) 6117-1 
Telex: 0524985 
A.CH.CM.E.MS,P 

GREAT BRITAIN 

Hewlett-Packard Ltd. 

Trafalgar House 

Navigation Road 

ALTRINCHAM 

Chesire WA14 1NU 

Tel: (061) 928-6422 

Telex: 668068 

A,CH.CS.E.M 

Hewlett-Packard Ltd. 

Oakfield House. Oakfield Grove 

Clifton 

BRISTOL BS8 2BN, Avon 

Tel: (027) 38606 

Telex: 444302 

CH.M,P 

Hewlett-Packard Ltd. 

(Pinewood) 

Nine Mile Ride 

EASTHAMPSTEAD 

Wokingham 

Berkshire. 3RG113LL 

Tel: 3446 3100 

Telex: 84-88-05 

CH.CS,E 

Hewlett-Packard Ltd. 

Fourier House 

257-263 High Street 

LONDON COLNEY 

Herts.. AL2 1HA. St. Albans 

Tel: (0727) 24400 

Telex: 1-8952716 

CH.CS.E 

Hewlett-Packard Ltd 

Tradax House. St. Mary's Walk 

MAIDENHEAD 

Berkshire. SL6 1ST 

Tel: (0628) 39151 

CH.CS.E.P 

Hewlett-Packard Ltd. 



106-118 Station Road 
REDHILL, Surrey 
Tel: (0737) 68655 
Telex: 947234 CH.CS,E 
Hewlett-Packard Ltd. 
Avon House 
435 Stratford Road 
SHIRLEY, Solihull 
West Midlands B90 4BL 
Tel: (021) 745 8800 
Telex: 339105 
CH 



Hewlett-Packard Ltd. 
West End House 41 
High Street, West End 
SOUTHAMPTON 
Hampshire 303 300 
Tel: (703) 886767 
Telex: 477138 
CH 

Hewlett-Packard Ltd. 
King Street Lane 
WINNERSH, Wokingham 
Berkshire RG115AR 
Tel: (0734) 784774 
Telex: 847178 
A,CH.E.M 



GREECE 

Kostas Karaynnis SA 

8 Omim Street 

ATHENS 133 

Tel: 32 30 303, 32 37 371 

Telex: 215962 RKARGR 

A,CH,CM.CS,EMP 

PLAISIO SA 

6. Gerardos 

24 Stoumara Street 

ATHENS 

Tel: 36-11-160 

Telex: 221871 

P 

GUATEMALA 

IPESA 

Avenlda Re forma 3-48, Zona 9 

GUATEUALACITY 

Tel: 316627, 314786 

Telex: 4192 TELTRO GU 

A.CH,CM,CS,E,M,P 

HONG KONG 

Hewlett-Packard Hong Kong, Ltd. 

G.P.O. Box 795 

5th Floor, Sun Hung Kai Centre 

30 Harbour Road 

HONGKONG 

Tel: 5-8323211 

Telex: 66678 HEWPA HX 

Cable: HEWPACK HONG KONG 

E,CH,CS,P 

CETLtd 

1402 Tung Way Mansion 

199-203 Hennessy Rd. 

Wanchia, HONGKONG 

Tel: 5-729376 

Telex: 85148 GET HX 

CM 

Schmidt & Co. (Hong Kong) Ltd. 

Wing On Centre, 28th Floor 

Connaught Road. C. 

HONGKONG 

Tel: 5-455644 

Telex: 74766 SCHMXHX 

A,M 

ICELAND 

Elding Trading Company Inc. 

Hafnarnvoli- Tryggvagotu 

P.O. Box 895 

IS-BEYKJAm 

Tel: 1-58-20, 1-63-03 

M 

INDIA 

Blue Star Ltd 
Sabri Complex II Floor 
24 Residency Rd. 
BANGALORE 560 025 
Tel: 55660 
Telex: 0845-430 
Cable: BLUESTAR 
A,CH,CM.CS.E 



Blue Star Ltd 
Band Box House 
PrabhadevI 
BOMBAY 400 025 
Tel: 422-3101 
Telex: 011-3751 
Cable: BLUESTAR 
A,M 
Blue Star Ltd 



^ 



4 14/2 W Savarkar Marg 

PrabhadevI 

BOMBAY 400 025 

Tel: 422-6155 

Telex: 011-4093 

Cable: FROSTBLUE 

A,CH,CM,CS,E.M 

Blue Star Ltd 

Kalyan, 19 Vishwas Colony 

Alkapuri, BOBODA, 390 005 

Tel: 65235 

Cable: BLUE STAR 

A 

Blue Star Ltd 

7 Hare Street 

CALCUTTA 700 001 

Tel: 12-01-31 

Telex: 021-7655 

Cable: BLUESTAR 

A.M 

Blue Star Ltd 

133 Kodambakkam H^h Road 

MADRAS 600 034 

Tel: 82057 

Telex: 041-379 

Cable: BLUESTAR 

A,M 

Blue Star Ltd. 

Bhandari House, 7th/8th Floors 

91 Nehni Place 

NEW DEUa 110 024 

Tel: 682547 

Telex: 031-2463 

Cable: BLUESTAR 

A,CH,CM,CS,E,M 

Blue Star Ltd 

15/16:C Wellesley Rd 

PUNE411011 

Tel: 22775 

Cable: BLUE STAR 

A 

Blue Star Ltd 

2-2-47/1 108 BolanjmRd 

SECUNDERABAD500003 

Tel: 72057 

Telex: 0155-459 

Cable: BLUEFROST 

A.E 

Blue Star Ltd 

T.C. 7/603 Poornlma 

Manjthankuzhl 

TRIVANDRUM695 013 

Tel: 65799 

Telex: 0884-259 

Cable: BLUESTAR 

E 

INDONESIA 

BERCA Indonesia P.T. 

P.0.BOX 496/JKT 

JL Abdul Muls 62 

JAKARTA 

Tel: 373009 

Telex: 46748 BERSAL lA 

Cable: BERSAL JAKARTA 

P 

BERCA Indonesia P.T. 

Wisma Antara Bkig., 17th floor 

JAKARTA 

A,CS,E.M 

BERCA Indonesia P.T. 

P.O. Box 174/SBY. 

JLKutelNo. 11 

SURABAYA 

Tel: 68172 

Telex: 31146 BERSAL SB 

Cable: BERSAL-SURABAYA 

A\E,M,P 



.^ 



■^ 
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IRAQ 

Hewlett-Packard Trading S.A. 

Service Operation 

Al Mansoor City 9B/3/7 

BAGHDAD 

Tel: 551-49-73 

Telex: 212-455 HEPAIRAO IK 

CH,CS 

IRELAND 

Hewlett-Packard Ireland Ltd. 

82/83 Lower Leeson St. 

DUBLIN 2 

Tel: (1)60 88 00 

Telex: 30439 

A.CH.CM.CS.E.M.P 

Cardiac Services Ltd. 

Kilmore Road 

Artane 

DUBLIN 5 

Tel: (01) 351820 

Telex: 30439 

M 

ISRAEL 

Eldan Electronic Instrument Ltd. 

P.O. Box 1270 

JERUSALEM 91000 

16, Ohallav SL 

JERUSALEM 94467 

Tel: 533 221, 553 242 

Telex: 25231 AB/PAKRD IL 

A 

Electronics Engineering Division 

Motorola Israel Ltd. 

16 Kremenetski Street 

P.O. Box 25016 

TEL-AVIV 67899 

Tel: 3-338973 

Telex: 33569 Motil IL 

Cable: BASTEL Tel-Aviv 

CH,CM,CS,E.M,P 

ITALY 

Hewlett-Packard Italiana S.p.A. 

Traversa 99C 

Via Giulio Petroni, 19 

1-70124 BARI 

Tel: (080) 41-07-44 

M 

Hewlett-Packard Italiana S.p.A. 

Via Martin Luther King. 38/1 11 

1-40132 BOLOGNA 

Tel: (051) 402394 

Telex: 511630 

CH.E,MS 

Hewlett-Packard Italiana S.p.A. 

Via Principe Nicola 43G/C 

1-95126 CATANIA 

Tel: (095) 37-10-87 

Telex: 970291 

C.P 

Hewlett-Packard Italiana S.p.A. 

Via G. Di Vittorio 9 

1-20063 CERNUSCO SUL NAVIGLIO 

Tel: (2) 903691 

Telex: 334632 

A.CH,CM.CS.E,MP.P 

Hewlett-Packard Italiana S.p.A. 

Via Nuova San Rocco a 

Capodimonte, 62/A 

1-80131 NAPLES 

Tel: (081) 7413544 

Telex: 710698 

A,CH,E 

Hewlett-Packard Italiana S.p.A. 

Viale G. Modugno 33 

1-16156 GENOVA PEGU 

Tel: (010) 68-37-07 

Telex: 215238 

E.C 



Hewlett-Packard italiana S.p.A. 

Via Turazza 14 

1-35100 PADOVA 

Tel: (049) 664888 

Telex: 430315 

A,CH.E.MS 

Hewlett-Packard Italiana S.p.A. 

Viale C. Pavese 340 

1-00144 ROMA 

Tel: (06) 54831 

Telex: 610514 

A.CH,CM,CS.E,MS.P* 

Hewlett-Packard Italiana S.p.A. 

Corso Svizzera. 184 

1-10149 TORINO 

Tel: (011) 74 4044 

Telex: 221079 

CH,E 

JAPAN 

Yokogawa-Hewlett-Packard Ltd. 

Inoue Building 

1-21-8, Asahi-cho 

ATSUGI, Kanagawa 243 

Tel: (0462) 28-0451 

CM.CE 

Yokogawa-Hewlett-Packard Ltd. 

Towa Building 

2-2-3, Kaigandori, Chuo-ku 

KOBE, 650, Hyogo 

Tel: (078) 392-4791 

C.E 

Yokogawa-Hewlett-Packard Ltd. 

Kumagaya Asahi Yasoji BIdg 4F 

3-4 Chome Tsukuba 

KUMAGAYA, Saitama 360 

Tel: (0485) 24-6563 

GH,CM.E 

Yokogawa-Hewlett-Packard Ltd. 

Asahi Shinbun Dai-ichi Seimei BIdg., 

2F 

4-7 Hanabata-cho 

KUMAM0T0-SHI,860 

Tel: (0963) 54-7311 

CH.E 

Yokogawa-Hewlett-Packard Ltd. 

Shin Kyoto Center BIdg. 5F 

614 Siokoji-cho 

Nishiiruhigashi. Karasuma 

Siokoji-dori, Shimogyo-ku 

KYOTO 600 

Tel: 075-343-0921 

CH,E 

Yokogawa-Hewlett-Packard Ltd. 
Mito Mitsui Building 
1-4-73, San-no-maru 
MITO, Ibaragi 310 
Tel: (0292) 25-7470 
CH,CM.E 

Yokogawa-Hewlett-Packard Ltd. 
Sumitomo Seimei Nagoya BIdg. 
2-14-19, Meieki-Minami, 
Nakamura-ku 
NAGOYA, 450 Aichi 
Tel: (052) 571-5171 
CH.CM.CS.E,MS 

Yokogawa-Hewlett-Packard Ltd. 
Chuo BIdg.. 4th Floor 
5-4-20 Nishinakajima. 
Yodogawa-ku 
OSAKA, 532 
Tel: (06) 304-6021 
Telex: YHPOSA 523-3624 
A,CH.CM,CS,E,MP,P* 
Yokogawa-Hewlett-Packard Ltd. 
1-27-15, Yabe, 
SAGAMIHARA Kanagawa, 229 
Tel: 0427 59-1311 
Yokogawa-Hewlett-Packard Ltd. 
Shinjuku Dai-ichi Seimei 6F 
2-7-1, Nishi Shinjuku 
Shinjuku-ku. TOKYO 160 
Tel: 03-348-4611-5 
CH.E 



Yokogawa-Hewlett-Packard Ltd. 
3-29-21 Takaldo-Higashi 
Suginami-ku TOKYO 168 
Tel: (03) 331-6111 
Telex: 232-2024 YHPTOK 
A,CH,CM.CS.E.MP,P* 

Yokogawa-Hewlett-Packard Ltd. 

Daiichi Asano Building 4F 

5-2-8, Oodorl, 

UTSUNOMIYA, 320 

Tochigi 

Tel: (0286) 25-7155 

CH, CS. E 

Yokogawa-Hewlett-Packard Ltd. 

Yasudaseimei Yokohama 

Nishiguchi BIdg. 

3-30-4 Tsuruya-cho 

Kanagawa-ku 

YOKOHAMA, Kanagawa. 221 

Tel: (045) 312-1252 

CH.CM.E 

JORDAN 

Mouasher Cousins Company 

P.O. Box 1387 

AMMAN 

Tel: 24907, 39907 

Telex: 21456 SABCO JO 

CH,E,M,P 

KENYA 

ADCOM Ltd., Inc.. Kenya 

P.O.Box 30070 

NAIROBI 

Tel: 331955 

Telex: 22639 

E,M 

KOREA 

Samsung Electronics Computer 

Division 

76-561 Yeoksam-Dong 

Kangnam-Ku 

C.P.O. Box 2775 

SEOUL 

Tel: 555-7555, 555-5447 

Telex: K27364 SAMSAN 

A,CH,CM,CS.EMP 

KUWAIT 

Al-Khaldiya Trading & Contracting 

P.O. Box 830 Safat 

KUWAIT 

Tel: 42-4910, 41-1726 

Telex: 22481 Areeg kt 

CH.E.M 

Photo & Cine Equipment 

P.O. Box 270 Safat 

KUWAIT 

Tel: 42-2846. 42-3801 

Telex: 22247 Matin-KT 

P 

LEBANON 

G.M. Dolmadjian 

Achrafieh 

P.O. Box 165 167 

BEIRUT 

Tel: 290293 

MP" 

LUXEMBOURG 

Hewlett-Packard Belgium S.A./N.V. 

Blvd de la Woluwe, 100 

Woluwedal 

B- 1200 BRUSSELS 

Tel: (02) 762-32-00 

Telex: 23-494 paloben bru 

A.CH,CM.CS.E.MP,P 



MALAYSIA 

Hewlett-Packard Sales (Malaysia) 

Sdn. Bhd. 

1st Floor. Bangunan British 

American 

Jalan Semantan. Damansara Heights 

KUALA LUMPUR 23-03 

Tel: 943022 

Telex: MA31011 

A,CH.E.M.P* 

Protel Engineering 

Lot 319, Satok Road 

P.O.Box 1917 

Kuching. SARAWAK 

Tel: 53544 

Telex: MA 70904 PROMAL 

Cable: PROTELENG 

A.E,M 

MALTA 

Philip Toledo Ltd 

Notabile Rd 

MRIEHEL 

Tel: 447 47, 455 66 

Telex: 649 Media MW 

P 

MEXICO 

Hewlett-Packard Mexicana. S.A. de 

C.V. 

Av. Periferico Sur No. 6501 

Tepepan. Xochimiico 

MEXICO D.F. 16020 

Tel: 676-4600 

Telex: 17-74-507 HEWPACK MEX 

A.CH.CS.E.MS.P 

Effective November 1. 1982: 

Hewlett-Packard Mexicana, S.A. de 

C.V. 

Ejercito Nacional #570 

Colonia Granada 

11560 MEXICO, D.F. 

CH'* 

Hewlett-Packard Mexicana. S.A. de 

C.V. 

Rio Volga 600 

Pte. Colonia del Valle 

MONTERREY, N.L. 

Tel: 78-42-93. 78-42-40. 78-42-41 

Telex: 038-2410 HPMTY ME 

CH 

Effective Nov. 1,1982 

Ave. Colonia del Valle ^409 

CoL del Valle 

Municinio de garza garcia 

MONTERREY, N.V. 

ECISA 

Taihe 229. Piso 10 

Polanco MEXICO D.F. 1 1570 

Tel: 250-5391 

Telex: 17-72755 ECE ME 

M 

MOROCCO 

Dolbeau 

81 rue Karatchi 

CASABLANCA 

Tel: 3041-82, 3068-38 

Telex: 23051. 22822 

E 

Gerep 

2 me d'Agadir 

Boite Postale 156 

CASABLANCA 

Tel: 272093, 272095 

Telex: 23 739 

P 

NETHERLANDS 

Hewlett-Packard Nedertand B.V. 
Van Heuven Goedhartiaan 121 
NL1181KKAMSTELVEEN 
P.O. Box 667 
NL1180ARAMSTELVEEN 
Tel: (20) 47-20-21 
Telex: 13 216 
A.CH.CM.CS.E,MP.P 



Hewlett-Packard Nedertand B.V. 

Bongerd 2 

NL 2g06VK CAPPELLE, A/D Ijessel 

P.O. Box 41 

NL2900AACAPELLE.Ijssel 

Tel: (10) 51-64-44 

Telex: 21261 HEPAC NL 

A.CH.CS 

NEW ZEALAND 

Hewlett-Packard (N.Z.) Ltd. 

169 Manukau Road 

P.O. Box 26-189 

Epsom. AUCKLAND 

Tel: 687-159 

Cable: HEWPACK Auckland 

CH,CM.E.P* 

Hewlett-Packard (N.Z.) Ltd. 

4-12 Cruickshank Street 

Klibirnie.WELUNGTONS 

P.O. Box 9443 

Courtenay Place, WEaiNGTON 3 

Tel: 877-199 

Cable: HEWPACK Wellington 

CH.CM.E.P 

Northrop Instruments S Systems 

Ltd 

369 Khyber Pass Road 

P.O. Box 8602 

AUCKLAND 

Tel: 794-091 

Telex: 60605 

A.M 

Northrop Instruments & Systems 

Ltd 

IIOMandevilleSt 

P.O. Box 8388 

CHRISTCHURCH 

Tel: 486-928 

Telex: 4203 

A,M 

Northrop Instmments & Systems 

Ltd 

Sturdee House 

85-87 Ghuznee Street 

P.O. Box 2406 

WELUNGTON 

Tel: 850-091 

Telex: NZ 3380 

A.M 

NORTHERN IRELAND 

Cardiac Services Company 
95A Finaghy Road South 
BELFAST BT 10 OBY 
Tel: (0232) 625-566 
Telex: 747626 
M 

NORWAY 

Hewlett-Packard Norge A/S 

Foike Bernadottes vei 50 

P.O. Box 3558 

N-5033 FYLLINGSDALEN (Bergen) 

Tel: (05) 16-55-40 

Telex: 16621 hpnas n 

CH.CS,E.MS 

Hewlett-Packard Norge A/S 

Osterndalen 18 

P.O. Box 34 

N-1345 6STER'AS 

Tel: (02) 17-11-80 

Telex: 16621 hpnas n 

A.CH.CM,CS.E,M,P 

OMAN 

Khimjil Ramdas 

P.O. Box 19 

MUSCAT 

Tel: 722225. 745601 

Telex: 3289 BROKER MB MUSCA T 

P 
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SALES & SUPPORT OFFICES 

Arranged Alphabetically by Country 



Suhail & Saud Bahwan 

P.O. Box 169 

MUSCAT 

Tel: 734 201-3 

Telex: 3274 BAHWAN MB 

PAKISTAN 

Mushko & Company Ltd. 

1'B. Street 43 

Sector F-8/1 

IStMABAD 

Tel: 26875 

Cable: FEMUS Rawalpindi 

A.E,M 

Mustiko & Company Ltd. 

Oosman Cl)ambers 

Atxiullah Haroon Road 

KARACHI 0302 

Tel: 511027, 512927 

Telex: 2894 MUSKO PK 

Cat>le: COOPERATOR Karachi 

A.EMP' 

PANAMA 

Electrdnico Balboa, S.A. 

Calle Samuel Lewis, Ed. Alfa 

Apartado 4929 

PANAMAS 

Tel: 64-2700 

Telex: 3483 ELECTRON PG 

A,CM,E.M,P 

Foto Intemaclonal, S.A. 

Colon Free Zone 

Apartado 2068 

COLONS 

Tel: 45-2333 

Telex: 8626 IMPORT PG 

P 

PERU 

Cia Electro Midica S.A. 

Los Flamencos 145, San Isidro 

Casilla 1030 

UMA 1 

Tel: 41-4325, 41-3703 

Telex: Pub. Booth 25306 

A,CM,E,M,P 

PHILIPPINES 

The Online Advanced Systems 

Corporation 

Rico House, Amorsolo Cor. Herrera 

Street 

Legaspi Village, Makati 

P.O. Box 1510 

Metro MANILA 

Tel: 85-35-81, 85-34-91, 85-32-21 

Telex: 3274 ONLINE 

A,CH,CS.E,M 

Electronic Specialists and 

Proponents Inc. 

690-B Epifanb de los Santos 

Avenue 

Cubao, QUEZON CITY 

P.O. Box 2649 Mantta 

Tel: 98-96-81, 98-96-82, 98-96-83 

Telex: 40018, 42000 lU GLOBE 

MACKAY BOOTH 

P 

PORTUGAL 

Mundinter 

Intercambio Mundial de ComSrcio 

S.a.r.l 

P.O. Box 2761 

Av. Antonio Augusto de Aguiar 138 

P-USBON 

Tel: (19) 53-21-31. 53-21-37 

Telex: 16691 munter p 

M 



Soquimica 

Av. da Liberdade, 220-2 

1298 LISBON Codex 

Tel: 56 21 81/2/3 

Telex: 13316 SABASAP 

Telectra-Empresa TScnica de 

Equipmentos ElSctricos S.a.r.L 

Rua Rodrigo da Fonseca 103 

P.O. Box 2531 

P-USBON 1 

Tel: (19) 68-60-72 

Telex: 12598 

CH,CS,E,P 

PUERTO RICO 

Hewlett-Packard Puerto Rico 

P.O. Box 4407 

CAROUNA. Puerto Rico 00628 

Calle 272 Edificio 203 

Urb. Country Club 

RIO PIEDRAS, Puerto Rico 00924 

Tel: (809) 762-7255 

A.CH,CS 

QATAR 

Nasser Trading & Contracting 

P.O. Box 1563 

DOHA 

Tel: 22170, 23539 

Telex: 4439 NASSER DH 

M 

Computearbia 

P.O. Box 2750 

DOHA 

Tel: 883555 

Telex: 4806 CHPARB 

P 

Eastern Technical Services 

P.O. Box 4747 

DOHA 

Tel: 329 993 

Telex: 4156 EASTEC DH 

SAUDI ARABIA 

Modern Electronic Establishment 

Hewlett-Packard Division 

P.O. Box 281 

Thuobah 

AL-KHOBAR 

Tel: 864-46 78 

Telex: 671 106HPMEEKSJ 

Cable: ELECTA AL-KHOBAR 

CH,CS,E,M,P 

Modern Electronic Establishment 

Hewlett-Packard Division 

P.O. Box 1228 

Redec Plaza, 6th Floor 

JEDDAH 

Tel: 644 38 48 

Telex: 402712 FARNAS SJ 

Cable: ELECTA JEDDAH 

CH,CS,E,M,P 

Modern Electronic Establishment 

Hewlett Packard Division 

P.O. Box 2728 

RIYADH 

Tel: 491-97 15, 491-63 87 

Telex: 202049 MEERYD SJ 

CH,CS,E,M.P 

SCOTLAND 

Hewlett-Packard Ltd. 

Royal Bank Buildings 

Swan Street 

BRECHIN, Angus. Scotland 

Tel: (03562) 3101-2 

CH 

Hewlett-Packard Ltd. 

SOUTH QUEENSFERRY 

West Lothian. EH30 9GT 

GB-Scotland 

Tel: (031) 3311188 

Telex: 72682 

A.CH.CM.CS,E.M 



SINGAPORE 

Hewlett-Packard Singapore (Pty.) 

Ltd. 

P.O. Box 58 Alexandra Post Office 

SINGAPORE, 91 15 

6th Floor, Inchcape House 

450-452 Alexandra Road 

SINGAPORE 0511 

Tel: 631788 

Telex: HPSGSO RS 34209 

Cable: HEWPACK. Singapore 

A.CH.CS,E,MS,P 

Dynamar International Ltd. 

Unit 05-11 Block 6 

Kolam Ayer Industrial Estate 

SINGAPORE 1334 

Tel: 747-6188 

Telex: RS 26283 

CM 

SOUTH AFRICA 

Hewlett-Packard So Africa (Pty.) Ltd. 

P.O. Box 120 

Howard Place 

Pine Park Center, Forest Drive, 

Pinelands 

CAPE PROVINCE 7405 

Tel: 53-7954 

Telex: 57-20006 

A.CH.CM,E,MS,P 

Hewlett-Packard So Africa (Pty.) Ltd. 

P.O. Box 37099 

92 Overport Drive 

DURBAN 4067 

Tel: 28-4178. 28-4179, 28-4110 

Telex: 6-22954 

CH,CM 

Hewlett-Packard So Africa (Ry.) Ltd. 

6 Linton Arcade 

511 Cape Road 

Linton Grange 

PORT EUZABETH 6001 

Tel: 041-302148 

CH 

Hewlett-Packard So Africa (Pty.) Ltd. 

P.O. Box 33345 

Glenstantia 0010 TRANSVAAL 

1st Floor East 

Constantia Park Ridge Shopping 

Centre 

Constantia Park 

PRETORIA 

Tel: 982043 

Telex: 32163 

CH.E 

Hewlett-Packard So Afrtea (Pty.) Ltd. 

Private Bag Wendywood 

SAN0T0N2144 

Tel: 802-5111, 802-5125 

Telex: 4-20877 

Cable: HEWPACK Johannesburg 

A,CH,CM,CS,E,MS,P 

SPAIN 

Hewlett-Packard Espaftola S.A. 

c/Entenza, 321 

E-BARCEL0NA29 

Tel: (3) 322-24-51, 321-73-54 

Telex: 52603 hpbee 

A.CH,CS,E,MS,P 

Hewlett-Packard Espafiola S.A. 

c/San Vicente S/N 

Edificio Albia 11,7 B 

E-BILBAO 1 

Tel: (4) 23-8306. (4) 23-8206 

A,CH,E,MS 

Hewlett-Packard Espafiola S.A. 

Calle Jerez 3 

E-MADRID 16 

Tel: (1) 458-2600 

Telex: 23515 hpe 

A,CM.E 



Hewlett-Packard Espafiola S.A. 

c/o Costa Brava 13 

Colonia Mirasierra 

E-MADRID 34 

Tel: (1)734-8061, (1)734-1162 

CH,CS,M 

Hewlett-Packard Espafiola S.A. 

Av Ram6n y Cajal 1-9 

Edificio Sevillal, 

E-SEVILLA 5 

Tel: 64-44-54. 64-44-58 

Telex: 72933 

A,CS,MS,P 

Hewlett-Packard Espaftola S.A. 

C/Ramon Gordlllo. 1 (Entlo.3) 

E-VALENCIA 10 

Tel: 361-1354, 361-1358 

CH,P 

SWEDEN 

Hewlett-Packard Sverige AB 

Sunnanvagen 14K 

S-22226 LUND 

Tel: (046) 13-69-79 

Telex: (854) 17886 (via SPANGA 

office) 

CH 

Hewlett-Packard Sverige AB 

Vastra Vintergatan 9 

S-70344 OREBRO 

Tel: (19) 10-48-80 

Telex: (854) 17886 (via SPANGA 

office) 

CH 

Hewlett-Packard Sverige AB 

Skalholtsgatan 9, Kista 

Box 19 , 

S- 16393 SPANGA 

Tel: (08) 750-2000 

Telex: (854) 17886 

A,CH,CM.CS,E,MS,P 

Hewlett-Packard Sverige AB 

Frdtallisgatan 30 

S-42132VASTRA-FR6lUNDA 

Tel: (031) 49-09-50 

Telex: (854) 17886 (via SPANGA 

office) 

CH,E,P 

SWITZERLAND 

Hewlett-Packard (Schweiz) AG 

Clarastrasse 12 

CH-4058 BASLE 

Tel: (61) 33-59-20 

A 

Hewlett-Packard (Schweiz) AG 

Bahnhoheweg 44 

CH-3018 BERN 

Tel: (031) 56-24-22 

CH 

Hewlett-Packard (Schweiz) AG 

47 Avenue Blanc 

CH-1202 GENEVA 

Tel: (022) 32-48-00 

CH.CM.CS 

Hewlett-Packard (Schweiz) AG 

19 Chemin Chateau Bloc 

CH-1219LEUGN0N-Geneva 

Tel: (022) 96-03-22 

Telex: 27333 hpag ch 

Cable: HEWPACKAG Geneva 

A,E,MS,P 

Hewlett-Packard (Schweiz) AG 

Allmend 2 

CH-8967 WIDEN 

Tel: (57) 31 21 11 

Telex: 53933 hpag ch 

Cable: HPAG CH 

A,CH.CM,CS.E,MS.P 

SYRIA 

General Electronic Inc. 

NurlBasha 

P.O. Box 5781 

DAMASCUS 

Tel: 33-24-87 

Telex: 11216 ITIKALSY 

Cable: ELECTROBOR DAMASCUS 

E 



Middle East Electronics 

Place AzmS 

Boite Postale 2308 

DAMASCUS 

Tel: 334592 

Telex: 1 1304 SATACO SY 

M,P 

TAIWAN 

Hewlett-Packard Far East Ltd. 

Kaohsiung Office 

2/F 68-2. Chung Cheng 3rd Road 

KAOHSIUNG 

Tel: 241-2318, 261-3253 

CH,CS,E 

Hewlett-Packard Far East Ltd. 

Taiwan Branch 

5th Floor 

205 Tun Hwa North Road 

TAIPEI 

Tel:(02) 751-0404 

Cable:HEWPACK Taipei 

A,CH,CM,CS.E,M.P 

Ing Lih Trading Co. 

3rd Floor, 7Jen-AlRoad. Sec. 2 

TAIPE1 100 

Tel: (02) 3948191 

Cable: INGLIH TAIPEI 

A 

THAILAND 

Unlmesa 

30 Patpong Ave., Surlwong 
BANGKOK 5 

Tel: 234 091, 234 092 

Telex: 84439 Slmonco TH 

Cable: UNIMESA Bangkok 

A,CH,CS,E,M 

Bangkok Business Equipment Ltd. 

5/5-6 Dejo Road 

BANGKOK 

Tel: 234-8670, 234-8671 

Telex: 87669-BEQUlPT TH 

Cable: BUSIOUIPT Bangkok 

P 

TRINIDAD & TOBAGO 

Caribbean Telecoms Ltd. 

50/ A Jernlngham Avenue 

P.O. Box 732 

PORT-OF-SPAIN 

Tel: 62-44213. 62-44214 

Telex: 235.272 HUGCO WG 

A,CM,E.M,P 

TUNISIA 

Tunlsle Electronlque 

31 Avenue de la Liberie 
TUNIS 

Tel: 280-144 

E,P 

Corema 

1 ter. Av. de Carthage 

TUNIS 

Tel: 253-821 

Telex: 12319 CABAMTN 

M 

TURKEY 

Teknlm Company Ltd. 

Iran Caddesl No. 7 

Kavaklldere. ANKARA 

Tel: 275800 

Telex: 42155 TKNM TR 

E 

E.M.A. 

Medina Eldem Sokak No.4 1/6 

Yuksel Caddesl 

ANKARA 

Tel: 175 622 

M 

UNITED ARAB EMIRATES 

Emltac Ltd. 

P.O.Box 1641 

SHARJAH 

Tel: 354121. 354123 

Telex: 68136 Emltac Sh 

CH.CS.E,M.P 
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UNITED KINGDOM 
see: GREAT BRITAIN 
NORTHERN IRELAND 
SCOTLAND 

UNITED STATES 

AOabama 

Hewlett-Packard Co. 
700 Century Park South 
Suite 128 

BIRMINGHAM, AL 35226 
Tel: (205) 822-6802 
CH.MP 

Hewlett-Packard Co. 
P.O. Box 4207 
8290 Whitesburg Drive. S.E. 
HUNTSVI11E,AL 35802 
Tel: (205) 881-4591 
CH.CM.CS.E,M* 

Alaska 

Hewlett-Packard Co. 
1577 "C" Street. Suite 252 
ANCHORAGE, AK 99501 
Tel: (907) 276-5709 
CH* 

Arizona 

Hewlett-Packard Co. 
2336 East Magnolia Street 
PHOENIX, AZ 85034 
Tel: (602) 273-8000 
A,CH,CM,CS.E.MS 
Hewlett-Packard Co. 
2424 East Aragon Road 
TUCSON, AZ 85706 
Tel: (602) 889-4631 
CH.E.MS'* 

Arkansas 

Hewlett-Packard Co. 

P.O. Box 5646 

Brady Station 

UTTLE ROCK, AR 72215 

111N.Filmore 

UTTlf ROCK, AR 72205 

Tel: (501) 664-8773. 376-1844 

MS 

California 

Hewlett-Packard Co. 
99 South HitI Or. 
BRISBANE, CA 94005 
Tel: (415) 330-2500 
CH.CS 

Hewlett-Packard Co. 
7621 Canoga Avenue 
CANOGA PARK, CA 91304 
Tel: (213) 702-8300 
A.CH.CS.E.P 
Hewlett-Packard Co. 
5060 Clinton Avenue 
FRESNO. CA 93727 
Tel: (209) 252-9652 
MS 

Hewlett-Packard Co. 
P.O. Box 4230 
1430 East Orangethorpe 
FULLERTON, CA 92631 
Tel: (714) 870-1000 
CH.CM.CS.E.MP 
Hewlett-Packard Co. 
320 S. Kellogg. Suite B 
G0LETA.CA 93117 
Tel: (805) 967-3405 
CH 

Hewlett-Packard Co. 

5400 W. Rosecrans Boulevard 

LAWNDALE,CA 90260 

P.O. Box 92105 

LOS ANGELES, CA 90009 

Tel: (213) 970-7500 

Telex: 910-325-6608 

CH.CM.CS.MP 

Hewlett-Packard Co. 
3200 Hillview Avenue 
PALO ALTO, CA 94304 
Tel: (415) 857-8000 
CH.CS.E 



Hewlett-Packard Co. 

P.O. Box 15976 (95813) 

4244 So. Market Court. Suite A 

SACRAMENTO, CA 95834 

Tel: (916) 929-7222 

A*.CH.CS.E.MS 

Hewlett-Packard Co. 

9606 Aero Drive 

P.O. Box 23333 

SAN DIEGO. CA 92123 

Tel: (714) 279-3200 

CH.CM.CS.E.MP 

Hewlett-Packard Co. 

2305 Camino Ramon "C 

SAN RAMON, CA 94583 

Tel: (415) 838-5900 

CH.CS 

Hewlett-Packard Co. 

P.O. Box 4230 

Fullerton. CA 92631 

363 Brookhollow Drive 

SANTA ANA. CA 92705 

Tel: (714) 641-0977 

A.CH.CM.CS.MP 

Hewlett-Packard Co. 

Suite A 

5553 Hollister 

SANTA BARBARA, CA 931 11 

Tel: (805) 964-3390 

Hewlett-Packard Co. 

3003 Scott Boulevard 

SANTA CURA,CA 95050 

Tel: (408) 988-7000 

A.CH.CM.CS.E.MP 

Hewlett-Packard Co. 

5703 Corsa Avenue 

WESTUKE VILUGE, CA 91362 

Tel: (213) 706-6800 

E'.CH'.CS* 

Colorado 

Hewlett-Packard Co. 
24 Inverness Place. East 
ENGLEWOOD. CO 80112 
Tel: (303) 771-3455 
Telex: 910-935-0785 
A.CH.CM.CS.E,MS 

Connecticut 

Hewlett-Packard Co. 

47 Barnes Industrial Road South 

P.O. Box 5007 

WALUNGFORD, CT 06492 

Tel: (203) 265-7801 

A.CH.CM.CS.E.MS 

Florida 

Hewlett-Packard Co. 

P.O. Box 24210 (33307) 

2901 N.W. 62nd Street 

FORT LAUDERDALE, FL 33307 

Tel: (305) 973-2600 

CH.CS.E.MP 

Hewlett-Packard Co. 

4080 Woodcock Drive. #132 

Brownett Building 

JACKSONVILLE, FL 32207 

Tel: (904) 398-0663 

C*.E'.MS*' 

Hewlett-Packard Co. 

1101 W. Hibiscus Ave., Suite E210 

MELBOURNE, FL 32901 

Tel: (305) 729-0704 

E* 

Hewlett-Packard Co. 

P.O. Box 13910 (32859) 

6177 Lake Ellenor Drive 

ORLANDO, FL 32809 

Tel: (305) 859-2900 

A.CH.CM.CS.E,MS 



Hewlett-Packard Co. 

6425 N. Pensacola Blvd. 

Suite 4. Building 1 

P.O. Box 12826 

PENSACOLA. FL 32575 

Tel: (904) 476-8422 

A.MS 

Hewlett-Packard Co. 

5750B N. Hoover Blvd.. Suite 123 

TAMPA, FL 33614 

Tel: (813) 884-3282 

A',CH.CM,CS.E*,M' 

Georgia 

Hewlett-Packard Co. 

P.O. Box 105005 

ATLANTA, GA 30348 

2000 South Park Place 

ATLANTA, GA 30339 

Tel: (404) 955-1500 

Telex: 810-766-4890 

A,CH,CM,CS.E.MP 

Hewlett-Packard Co. 

P.O. Box 816 (80903) 

2531 Center West Parkway 

Suite 110 

AUGUSTA, GA 30904 

Tel: (404) 736-0592 

MS 

Hewlett-Packard Co. 

200-E Montgomery Cross Rds. 

SAVANNAH. GA 31401 

Tel:(912) 925-5358 

CH** 

Hewlett-Packard Co. 

P.O. Box 2103 

WARNER ROBINS, GA 31099 

1172 N. Davis Drive 

WARNER ROBINS. GA 31093 

Tel: (912) 923-8831 

E 

Hawaii 

Hewlett-Packard Co. 
Kawaiahao Plaza, Suite 190 
567 South King Street 
HONOLULU, HI 96813 
Tel: (808) 526-1555 
A.CH,E.MS 

Illinois 

Hewlett-Packard Co. 
21 1 Prospect Road. Suite C 
BLOOMINGTON, IL 61701 
Tel: (309) 662-9411 
CH.MS** 

Hewlett-Packard Co. 
1100 31st Street. Suite 100 
DOWNERS GROVE.il 60515 
Tel: (312) 960-5760 
CH.CS 

Hewlett-Packard Co. 
5201 Tollview Drive 
ROLUNG MEADOWS, 11 60008 
Tel: (312) 255-9800 
A.CH.CM.CS.E,MP 

Indiana 

Hewlett-Packard Co. 

P.O. Box 50807 

7301 No. Shadeland Avenue 

INDIANAPOUS. IN 46250 

Tel: (317) 842-1000 

A.CH,CM.CS.E.MS 

Iowa 

Hewlett-Packard Co. 
1776 22nd Street, Suite 1 
WEST DES MOINES, lA 50265 
Tel: (515) 224-1435 
CH.MS** 

Hewlett-Packard Co. 
2415 Heinz Road 
IOWA CITY, lA 52240 
Tel: (319) 351-1020 
CH,E*,MS 



Kansas 

Hewlett-Packard Co. 
1644 S. Rock Road 
WICHITA, KA 67207 
Tel: (316) 684-8491 
CH 

Kentucky 

Hewlett-Packard Co. 
10300 Linn Station Road 
Suite 100 

LOUISVILLE, KY 40223 
Tel: (502) 426-0100 
A,CH.CS.MS 

Louisiana 

Hewlett-Packard Co. 
8126 Calais BIdg. 
BATON ROUGE, LA 70806 
Tel: (504) 467-4100 
A**.CH** 

Hewlett-Packard Co. 
P.O. Box 1449 
KENNER. LA 70062 
160 James Drive East 
DESTAHAN, LA 70047 
Tel: (504) 467-4100 
A.CH.CS.E.MS 

Maryland 

Hewlett-Packard Co. 
7121 Standard Drive 
HANOVER, MD 21076 
Tel: (301) 796-7700 
Telex: 710-862-1943 
Eft. Dec. 1. 1982 
3701 Koppers St. 
BALTIMORE, MD 21227 
Tel: (301) 644-5800 
A.CH,CM.CS.E.MS 
Hewlett-Packard Co. 
2 Choke Cherry Road 
ROCKViLLE. MD 20850 
Tel: (301) 948-6370 
A.CH,CM,CS.E.MP 

Massachusetts 

Hewlett-Packard Co. 
32 Hartwell Avenue 
LEXINGTON. MA 02173 
Tel: (617) 861-8960 
A,CH.CM.CS.E.MP 

Michigan 

Hewlett-Packard Co. 
23855 Research Drive 
FARMINGTON HILLS, Ml 48024 
Tel: (313) 476-6400 
A,CH,CM,CS.E.MP 
Hewlett-Packard Co. 
4326 Cascade Road S.E. 
GRAND RAPIDS, Ml 49506 
Tel: (616) 957-1970 
CH.CS.MS 

Hewlett-Packard Co. 
1771 W. Big Beaver Road 
TROY. Ml 48084 
Tel: (313) 643-6474 
CH.CS 

Minnesota 

Hewlett-Packard Co. 
2025 W. Larpenteur Ave. 
ST.PAUL,MN 55113 
Tel: (612) 644-1 100 
A.CH.CM.CS.E.MP 

Mississippi 

Hewlett-Packard Co. 
P.O. Box 5028 
1675 Lakeland Drive 
JACKSON. MS 39216 
Tel: (601) 982-9363 
MS 

Missouri 

Hewlett-Packard Co. 
11131 Colorado Avenue 
KANSAS CITY. MO 64137 
Tel: (816) 763-8000 
A.CH.CM.CS.E.MS 



Hewlett-Packard Co. 
P.O. Box 27307 
1024 Executive Parkway 
ST. LOUIS, MO 63141 
Tel: (314) 878-0200 
A,CH.CS.E.MP 
Effective September 1982: 
13001 Hollenberg Drive 
BRIDGETON, MO 63044 

Nebraska 

Hewlett-Packard 
7101 Mercy Road 
Suite 101. IBX Building 
OMAHA, NE 68106 
Tel: (402) 392-0948 
CM.MS 

Nevada 

Hewlett-Packard Co. 
Suite D-130 
5030 Paradise Blvd. 
USVEGAS,NV 89119 
Tel: (702) 736-6610 
MS** 

New Jersey 

Hewlett-Packard Co. 
W120 Century Road 
PARAMUS, NJ 07652 
Tel: (201) 265-5000 
A.CH.CM.CS,E.MP 
Hewlett-Packard Co. 
60 New England Av. West 
PISCATAWAY, NJ 08854 
Tel: (201) 981-1199 
A.CH.CM.CS.E 

New Mexico 

Hewlett-Packard Co. 
P.O. Box 11634 
ALBUQUERQUE, NM 87112 
11300LomasBlvd..N.E. 
ALBUQUERQUE, NM 87123 
Tel: (505) 292-1330 
Telex: 910-989-1185 
CH.CS.E.MS 

New York 

Hewlett-Packard Co. 
5 Computer Drive South 
ALBANY, NY 12205 
Tel: (518) 458-1550 
Telex: 710-444-4691 
A.CH.E,MS 
Hewlett-Packard Co. 
P.O. Box 297 
9600 Main Street 
CURENCE. NY 14031 
Tel: (716) 759-8621 
Telex: 710-523-1893 
CH 

Hewlett-Packard Co. 
200 Cross Keys Office 
FAIRPORT. NY 14450 
Tel: (716) 223-9950 
Telex: 510-253-0092 
CH.CM.CS,E.MS 
Hewlett-Packard Co. 
7641 Henry Clay Blvd. 
UVERPOOL, NY 13088 
Tel: (315) 451-1820 
A,CH.CM,E.MS 
Hewlett-Packard Co. 
No. 1 Pennsylvania Plaza 
55th Floor 

34th Street & 8th Avenue 
NEW YORK, NY 10119 
Tel: (212) 971-0800 
CH,CS,E*.M* 



S 



[7] SALES & SUPPORT OFFICES 

gd Arranged Alphabetically by Country 



Hewlett-Packard Co. 
250 Westchester Avenue 
WHITE PUUNS, NY 10604 
CM.CH.CS.E 
Hewlett-Packard Co. 
3 Crossways Park West 
WOODBURY, NY 11797 
Tel: (516) 921-0300 
Telex: 510-221-2183 
A.CH.CM.CS.E.MS 

North Carolina 

Hewlett-Packard Co. 
4915 Water's Edge Drive 
Suite 160 

RALEIGH, NC 27606 
Tel: (919) 851-3021 
CM 

Hewlett-Packard Co. 
P.O. Box 26500 
5605 Roanne Way 
GREENSBORO, NC 27450 
Tel: (919) 852-1800 
A.CH.CM.CS,E.MS 

Ohio 

Hewlett-Packard Co. 
9920 Carver Road 
CINaNNATI, OH 45242 
Tel: (513) 891-9870 
CH.CS,MS 

Hewlett-Packard Co. 
16500 Sprague Road 
CLEVELAND, OH 44130 
Tel: (216) 243-7300 
Telex: 810-423-9430 
A,CH,CM.CS.E.MS 
Hewlett-Packard Co. 
962 Crupper Ave. 
COLUMBUS, OH 43229 
Tel: (614) 436-1041 
CH.CM.CS.E* 
Hewlett-Packard Co. 
P.O. Box 280 
330 Progress Rd. 
DAYTON. OH 45449 
Tel: (513) 859-8202 
A.CH,CM.E*.MS 

Olclahoma 

Hewlett-Packard Co. 

P.O. Box 32008 

Oklahoma City. OK 73123 

1503 W. Gore Blvd.. Suite #2 

LAWTON, OK 73505 

Tel: (405) 248-4248 

C 

Hewlett-Packard Co. 

P.O. Box 32008 

OKLAHOMACITY, OK 73123 

304 N. Meridian Avenue. Suite A 

OKLAHOMA CITY, OK 73107 

Tel: (405) 946-9499 

A*.CH.E*,MS 

Hewlett-Packard Co. 

Suite 121 

9920 E. 42nd Street 

TULSA, OK 74145 

Tel: (918) 665-3300 

A*'.CH,CS.M* 

Oregon 

Hewlett-Packard Co. 
1500 Valley River Drive 
Suite 330 
EUGENE. OR 97401 
Tel: (503) 683-8075 
C 

Hewlett-Packard Co. 
9255 S. W. Pioneer Court 
WtLSONVILLE, OR 97070 
Tel: (503) 682-8000 
A.CH.CS.E*.MS 



Pennsylvania 

Hewlett-Packard Co. 
1021 8th Avenue 
King of Prussia Industrial Park 
KING OF PRUSSIA, PA 19406 
Tel: (215) 265-7000 
Telex: 510-660-2670 
A.CH.CM.CS.E.MP 
Hewlett-Packard Co. 
Ill Zeta Drive 
PinSBURGH, PA 15238 
Tel: (412) 782-0400 
A.CH.CS.E,MP 

South Carolina 

Hewlett-Packard Co. 
P.O. Box 21708 
Brookside Park. Suite 122 
1 Harbison Way 
COLUMBIA. SC 29210 
Tel: (803) 732-0400 
CH.E.MS 

Hewlett-Packard Co. 
Koger Executive Center 
Chesterfield BIdg.. Suite 124 
GREENVILLE, SC 29615 
Tel: (803) 748-5601 
C 

Tennessee 

Hewlett-Packard Co. 
P.O. Box 22490 
224 Peters Road 
Suite 102 

KNOXVILLE, TN 37922 
Tel: (615) 691-2371 
A*.CH.MS 

Hewlett-Packard Co. 
3070 Directors Row 
MEMPHIS, TN 38131 
Tel: (901) 346-8370 
A.CH.MS 

Hewlett-Packard Co. 
230 Great Circle Road 
Suite 216 

NASHVILLE, TN 32228 
Tel: (615) 255-1271 
MS** 

Texas 

Hewlett-Packard Co. 

Suite 310W 

7800 Shoaicreek Blvd. 

AUSTIN, TX 78757 

Tel: (512) 459-3143 

E 

Hewlett-Packard Co. 

Suite C- 110 

4171 North Mesa 

EL PASO, TX 79902 

Tel: (915) 533-3555. 533-4489 

CH,E*.MS** 

Hewlett-Packard Co. 

5020 Mark IV Parkway 

F0RTW0RTH.TX 76106 

Tel: (817) 625-6361 

CH.CS* 

Hewlett-Packard Co. 

P.O. Box 42816 

HOUSTON, TX 77042 

10535 Harwin Street 

HOUSTON, TX 77036 

Tel: (713) 776-6400 

A.CH.CM.CS.E.MP 

Hewlett-Packard Co. 

3309 67th Street 

Suite 24 

LUBBOCK, TX 79413 

Tel: (806) 799-4472 

M 



Hewlett-Packard Co. 
417 Nolana Gardens. Suite C 
P.O. Box 2256 
McALLEN, TX 78501 
Tel: (512) 781-3226 
CH,CS 

Hewlett-Packard Co. 
P.O. Box 1270 
RICHARDSON, TX 75080 
930 E. Campbell Rd. 
RICHARDSON, TX 75081 
Tel: (214) 231-6101 
A.CH.CM.CS.E,MP 
Hewlett-Packard Co. 
P.O. Box 32993 
SANANT0NI0,TX 78216 
1020 Central Parkway South 
SAN ANTONIO. TX 78232 
Tel: (512) 494-9336 
CH.CS.E.MS 

Utah 

Hewlett-Packard Co. 
P.O. Box 26626 
3530 W. 2100 South 
SALTLAKECITY.UT 84119 
Tel: (801) 974-1700 
A.CH.CS,E.MS 

Virginia 

Hewlett-Packard Co. 

P.O. Box 9669 

2914 Hungary Spring Road 

RICHMOND, VA 23228 

Tel: (804) 285-3431 

A.CH,CS.E.MS 

Hewlett-Packard Co. 

3106 Peters Creek Road. N.W. 

ROANOKE. VA 24019 

Tel: (703) 563-2205 

CH.E** 

Hewlett-Packard Co. 

5700 Thurston Avenue 

Suite 111 

VIRGINIA BEACH, VA 23455 

Tel: (804) 460-2471 

CH.MS 

Washington 

Hewlett-Packard Co. 
15815 S.E. 37th Street 
BELLEVUE,WA 98006 
Tel: (206) 643-4.000 
A.CH.CM,CS.E.MP 
Hewlett-Packard Co. 
Suite A 

708 North Argonne Road 
SPOKANE, WA 99206 
Tel: (509) 922-7000 
CH.CS 

West Virginia 

Hewlett-Packard Co. 
4604 MacCorkle Ave.. S.E. 
CHARLESTON. WV 25304-4297 
Tel: (304) 925-0492 
A.MS 

Wisconsin 

Hewlett-Packard Co. 
150 S. Sunny Slope Road 
BROOKFIELD. Wl 53005 
Tel: (414) 784-8800 
A.CH.CS,E*.MP 

URUGUAY 

Pablo Ferrando SAC. e L 

Avenida Italia 2877 

Casilla de Correo 370 

MONTEVIDEO 

Tel: 80-2586 

Telex: Public Booth 901 

A.CM,EM 



Guillermo Kraft del Uruguay S.A. 

Av. Lib. Brig. Gral. Lavalleja 2083 

MONTEVIDEO 

Tel: 234588, 234808. 208830 

Telex: 22030 ACTOUR UY 

P 

VENEZUELA 

Hewlett-Packard de Venezuela C.A. 

3A Transversal Los Ruices Norte 

Edificio Segre 

Apartado 50933 

CARACAS 1071 

Tel: 239-4133 

Telex: 25146 HEWPACK 

A.CH.CS.E.MS.P 

Colimodio S.A. 

Este 2 - Sur 21 No. 148 

Apartado 1053 

CARACAS 1010 

Tel: 571-3511 

Telex: 21529 COLMODIO 

M 



ZilMBABWE 

Field Technical Sales 
45 Kelvin Road, North 
P.B 3458 
SAUSBUBY 
Tel: 705 231 
Telex: 4-122 RH 
C,E.M,P 



Headquarters offices 
if there is no sales office iisted for your area, 
contact one of these headquarters offices. 

MEDiTERRANEAN AND 
MIDDLE EAST 

Hewlett-Packard S.A. 

Mediterranean and Middle East 

Operations 

Atrlna Centre 

32 Kifissias Ave. 

Maroussi. ATHENS, Greece 

Tel: 682 88 11 

Telex: 21-6588 HPAT GR 

Cable: HEWPACKSA Athens 



/-i^ 



NORTH/CENTRAL 
AFRICA 

Hewlett-Packard S.A. 
7 Rue du Bois-du-Lan 
CH-1217MEYRIN 2, Switzerland 
Tel: (022) 98-96-51 
Telex: 27835 hpse 
Cable: HEWPACKSA Geneve 

ASIA 

Hewlett-Packard Asia Ltd. 
6th Floor, Sun Hung Kai Center 
30 Harbor Rd. 
G.P.O. Box 795 
HONGKONG 
Tel: 5-832 3211 
Telex: 66678 HEWPA HX 
Cable: HEWPACK HONG KONG 

CANADA 

Hewlett-Packard (Canada) Ltd. 
6877 Goreway Drive 
MISSISSAUGA. Ontario L4V 1M8 
Tel: (416) 678-9430 
Telex: 610-492-4246 

EASTERN EUROPE 

Hewlett-Packard Ges.m.b.h. 

Lieblgasse 1 

P.O.Box 72 

A-1222 VIENNA, Austria 

Tel: (222) 2365110 

Telex: 1 3 4425 HEPA A 

NORTHERN EUROPE 

Hewlett-Packard S.A. 
Uilenstede 475 
NL-1183AGAMSTELVEEN 
The Netherlands 
P.O.Box 999 
NL-1180AZAMSTELVEEN 
The Netherlands 
Tel: 20 437771 

OTHER EUROPE 

Hewlett-Packard S.A. 
7 Rue du Bois-du-Lan 
CH-1217MEYRIN 2, Switzerland 
Tel: (022) 98-96-51 
Telex: 27835 hpse 
Cable: HEWPACKSA Geneve 
(Offices in the World Trade Center) 
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EASTERN USA 

Hewlett-Packard Co. 
4 Choke Cherry Road 
Rockviile, MD 20850 
Tel: (301) 258-2000 

MIDWESTERN USA 

Hewlett-Packard Co. 
5201 Toilview Drive 
ROLLING MEADOWS, IL 60008 
Tel: (312) 255-9800 

SOUTHERN USA 

Hewlett-Packard Co. 
P.O. Box 105005 
450 Interstate N. Parkway 
ATUNTA, GA 30339 
Tel: (404) 955-1500 

WESTERN USA 

Hewlett-Packard Co. 
3939 Lankersim Blvd. 
L0SANGELES,CA 91604 
Tel: (213) 877-1282 

OTHER INTERNATIONAL 

AREAS 

Hewlett-Packard Co. 
Intercontinental Headquarters 
3495 Deer Creek Road 
PALO ALTO. CA 94304 
Tel: (415) 857-1501 
Telex: 034-8300 
Cable: HEWPACK 
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